Endpoint de produtos

NOTE
Se um token de usuário for transmitido, o usuário do token deverá ter uma função de "org admin" para a organização solicitada.

O ponto de extremidade /products na API de controle de acesso baseado em atributos permite gerenciar programaticamente os produtos, bem como as categorias de permissões e os conjuntos de permissões associados aos produtos em sua organização.

Introdução

O endpoint da API usado neste guia faz parte da API de controle de acesso baseada em atributos. Antes de continuar, consulte o guia de introdução para obter links para a documentação relacionada, um guia para ler as chamadas de API de exemplo neste documento e informações importantes sobre os cabeçalhos necessários para fazer chamadas para qualquer API Experience Platform com êxito.

Recuperar uma lista de produtos autorizados list

Você pode recuperar uma lista de produtos autorizados fazendo uma solicitação GET para o ponto de extremidade /products.

Formato da API

GET /products/

Solicitação

A solicitação a seguir recupera uma lista de produtos autorizados pertencentes à sua organização.

curl -X GET \
  https://platform.adobe.io/data/foundation/access-control/administration/products \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {IMS_ORG}' \

Resposta

Uma resposta bem-sucedida retorna uma lista de produtos qualificados pertencentes à sua organização.

{
  "products": [
    {
      "id": "{ID}",
      "name": "Adobe Experience Platform",
      "serviceCode": "{SERVICE_CODE}"
    }
  ]
}
Propriedade
Descrição
id
A ID correspondente do produto consultado.
name
O nome do produto consultado.
serviceCode
O código de serviço correspondente do produto consultado.

Pesquisar categorias de permissão por ID de produto

Você pode pesquisar categorias de permissão para um determinado produto fazendo uma solicitação GET para o ponto de extremidade /products/{PRODUCT_ID}/categories ao especificar a ID do produto.

Formato da API

GET /products/{PRODUCT_ID}/categories
Parâmetro
Descrição
A ID do produto associado às categorias de permissão que você deseja pesquisar.

Solicitação

A solicitação a seguir recupera categorias de permissão associadas a {PRODUCT_ID}.

curl -X GET \
  https://platform.adobe.io/data/foundation/access-control/administration/products/{PRODUCT_ID}/categories \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {IMS_ORG}' \

Resposta

Uma resposta bem-sucedida retorna as categorias de permissão associadas à ID do produto consultada.

{
  "categories": [
    {
        "name": "Profile Management"
    },
    {
        "name": "Data Ingestion"
    },
    {
        "name": "Sandbox Administration"
    },
    {
        "name": "Query Service"
    },
    {
        "name": "Data Management"
    },
    {
        "name": "Identity Management"
    },
    {
        "name": "Data Modeling"
    },
    {
        "name": "Data Science Workspace"
    },
    {
        "name": "Dashboards"
    },
    {
        "name": "Alerts"
    },
    {
        "name": "Data Governance"
    }
  ]
}
Propriedade
Descrição
category
As categorias de permissão disponíveis na ID do produto consultada.
name
O nome da categoria de permissão.

Pesquisar conjuntos de permissões por ID de produto

Você pode pesquisar conjuntos de permissões para um determinado produto fazendo uma solicitação GET para o ponto de extremidade /products/{PRODUCT_ID}/permission-sets ao especificar a ID do produto.

Formato da API

GET /products/{PRODUCT_ID}/permission-sets
Parâmetro
Descrição
A ID do produto associado aos conjuntos de permissões que você deseja pesquisar.

Solicitação

A solicitação a seguir recupera conjuntos de permissões associados a {PRODUCT_ID}.

curl -X GET \
  https://platform.adobe.io/data/foundation/access-control/administration/products/{PRODUCT_ID}/permission-sets \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {IMS_ORG}' \

Resposta

Uma resposta bem-sucedida retorna os conjuntos de permissões associados à ID do produto consultada.

{
  "permission-sets": [
      {
          "id": "manage-schemas",
          "name": "Manage Schemas",
          "category": "Data Modeling",
          "permissions": [
              {
                  "resource": "schemas",
                  "actions": [
                      "read",
                      "write",
                      "delete"
                  ]
              },
              {
                  "resource": "schema-fields",
                  "actions": [
                      "read",
                      "write",
                      "delete"
                  ]
              },
              {
                  "resource": "sandboxes",
                  "actions": [
                      "view"
                  ]
              }
          ]
      },
      {
          "id": "view-schemas",
          "name": "View Schemas",
          "category": "Data Modeling",
          "permissions": [
              {
                  "resource": "schemas",
                  "actions": [
                      "read"
                  ]
              },
              {
                  "resource": "schema-fields",
                  "actions": [
                      "read"
                  ]
              },
              {
                  "resource": "sandboxes",
                  "actions": [
                      "view"
                  ]
              }
          ]
      },
  ]
}
Propriedade
Descrição
permission-sets
Os conjuntos de permissões representam um grupo de permissões que um administrador pode aplicar a uma função. Um administrador pode atribuir conjuntos de permissões a uma função, em vez de atribuir permissões individuais. Isso permite criar funções personalizadas com base em uma função predefinida que contém um grupo de permissões.
id
A ID correspondente do conjunto de permissões consultado.
name
O nome correspondente do conjunto de permissões consultado.
category
A categoria de permissão disponível.
permissions
As permissões incluem a capacidade de visualizar e/ou usar recursos da Platform, como criar sandboxes, definir esquemas e gerenciar conjuntos de dados.
permissions.resource
O ativo ou objeto que um assunto pode ou não acessar. Os recursos podem ser arquivos, aplicativos, servidores ou até mesmo APIs.
permissions.actions
A ação que um assunto tem permissão para realizar em um recurso consultado. Os valores possíveis incluem: view, read, create, edit e delete
recommendation-more-help
631fcab2-5cb1-46ef-ba66-fe098ac723e0