Ponto de extremidade de produtos

IMPORTANTE

O controle de acesso baseado em atributos está disponível em uma versão limitada para clientes de assistência médica com base nos EUA. Esse recurso estará disponível para todos os clientes da Real-time Customer Data Platform assim que for totalmente lançado.

O /products O endpoint na API de controle de acesso baseada em atributos permite gerenciar programaticamente produtos, bem como categorias de permissão e conjuntos de permissões associados a 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, reveja o guia de introdução para 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 com êxito para qualquer API do Experience Platform.

Recuperar uma lista de produtos autorizados

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

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 autorizados 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 do GET para a variável /products/{PRODUCT_ID}/categories endpoint ao especificar a ID do produto.

Formato da API

GET /products/{PRODUCT_ID}/categories
Parâmetro Descrição
A ID do produto associada à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 de produto que você consultou.

{
  "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 de produto consultada.
name O nome da categoria de permissão.

Pesquisar conjuntos de permissões por ID de produto

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

Formato da API

GET /products/{PRODUCT_ID}/permission-sets
Parâmetro Descrição
A ID do produto associada 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 que você consultou.

{
  "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 a partir de 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 exibir e/ou usar recursos da plataforma, 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 fazer contra um recurso consultado. Os valores possíveis incluem: view, read, create, edite delete

Nesta página