Atribuir uma chave de API da organização a um projeto

URL base: https://cloud.mongodb.com/api/public/v1.0

Resource

PATCH /groups/{PROJECT-ID}/apiKeys/{API-KEY-ID}

Parâmetros do caminho da solicitação

Nome	Tipo	Descrição
`PROJECT-ID`	string	Identificador exclusivo do projeto cujas chaves de API você deseja atualizar. Use o endpoint /groups para recuperar todas as organizações às quais o usuário autenticado tem acesso.
`API-KEY-ID`	string	Identificador exclusivo da chave de API que você deseja atualizar. Faça uma solicitação ao ponto de extremidade /groups/{ID do grupo}/apiKeys para recuperar todas as chaves API às quais o usuário autenticado tem acesso para a organização especificada.

Solicitar parâmetros de query

Os seguintes parâmetros de query são opcionais:

Nome	Tipo	Descrição	Default
pageNum	inteiro	Número da página (com base em índice 1).	`1`
itemsPerPage	inteiro	Número de itens a serem devolvidos por página, até um máximo de 500.	`100`
pretty	booleano	Indica se o corpo da resposta deve ser retornado em um formato prettyprint.	`false`
envelope	booleano	Indica se deve envolver a resposta em um envelope. Alguns clientes de API não podem acessar os cabeçalhos de resposta HTTP ou o código de status. Para corrigir isso, configure `"envelope" : true` na query. Para endpoints que retornam um resultado, o corpo da resposta inclui: `status`: Código de resposta HTTP `content`: Corpo de resposta esperado Para endpoints que retornam uma lista de resultados, o objeto `results` é um envelope. O Cloud Manager adiciona o campo `status` ao corpo da resposta.	none

Parâmetros do corpo da solicitação

Nome	Tipo	necessidade	Descrição
`roles`	array	Obrigatório	Lista de funções que a API Key deve receber. Deve ser fornecida pelo menos uma função. As funções fornecidas devem ser válidas para o projeto atribuído: `GROUP_AUTOMATION_ADMIN`: `Project Automation Admin` `GROUP_BACKUP_ADMIN`: `Project Backup Admin` `GROUP_DATA_ACCESS_ADMIN`: `Project Data Access Admin` `GROUP_DATA_ACCESS_READ_ONLY`: `Project Data Access Read Only` `GROUP_DATA_ACCESS_READ_WRITE`: `Project Data Access Read/Write` `GROUP_MONITORING_ADMIN`: `Project Monitoring Admin` `GROUP_OWNER`: `Project Owner` `GROUP_READ_ONLY`: `Project Read Only` `GROUP_USER_ADMIN`: `Project User Admin`

Resposta

Nome	Tipo	Descrição
`desc`	string	Descrição desta chave de API da Organização atribuída a este projeto.
`id`	string	Identificador exclusivo para esta chave de API da organização atribuída a este projeto.
`privateKey`	string	Chave privada editada para esta chave de API da Organização atribuída a este projeto. Essa chave é exibida sem edição quando criada pela primeira vez.
`publicKey`	string	Chave pública para esta chave de API da Organização atribuída a este Projeto.
`roles`	array de objetos	Funções que essa chave de API da organização atribuída a esse projeto tem. Essa matriz retorna todos os papéis da organização e do projeto que o usuário tem no Cloud Manager.
`roles.groupId`	string	Identificador único do projeto ao qual pertence este role.
`roles.orgId`	string	Identificador único da organização à qual pertence esse role.
`roles.roleName`	string	Nome da função. Esse recurso retorna todos os roles que o usuário tem no Cloud Manager. Os valores possíveis são: Roles da organização Se esta for uma `roles.orgId` (Organização), os valores incluem: `ORG_OWNER`: `Organization Owner` `ORG_MEMBER`: `Organization Member` `ORG_GROUP_CREATOR`: `Organization Project Creator` `ORG_BILLING_ADMIN`: `Organization Billing Admin` `ORG_READ_ONLY`: `Organization Read Only` `ORG_BILLING_READ_ONLY`: `Organization Billing Viewer` Roles do projeto Se este for um `roles.groupId` (Projeto), os valores incluem: `GROUP_AUTOMATION_ADMIN`: `Project Automation Admin` `GROUP_BACKUP_ADMIN`: `Project Backup Admin` `GROUP_DATA_ACCESS_ADMIN`: `Project Data Access Admin` `GROUP_DATA_ACCESS_READ_ONLY`: `Project Data Access Read Only` `GROUP_DATA_ACCESS_READ_WRITE`: `Project Data Access Read/Write` `GROUP_MONITORING_ADMIN`: `Project Monitoring Admin` `GROUP_OWNER`: `Project Owner` `GROUP_READ_ONLY`: `Project Read Only` `GROUP_USER_ADMIN`: `Project User Admin`

Exemplo de solicitação

1curl --user "{PUBLIC-KEY}:{PRIVATE-KEY}" --digest \2     --header "Accept: application/json" \3     --header "Content-Type: application/json" \4     --include \5     --request PATCH "https://cloud.mongodb.com/api/public/v1.0/groups/{PROJECT-ID}/apiKeys/{API-KEY-ID}?pretty=true"6     --data '{7       "roles": [ "GROUP_READ_ONLY", "GROUP_DATA_ACCESS_READ_WRITE" ]8     }'

Exemplo de resposta

Cabeçalho de resposta

HTTP/1.1 401 UnauthorizedContent-Type: application/json;charset=ISO-8859-1Date: {dateInUnixFormat}WWW-Authenticate: Digest realm="MMS Public API", domain="", nonce="{nonce}", algorithm=MD5, op="auth", stale=falseContent-Length: {requestLengthInBytes}Connection: keep-alive

HTTP/1.1 200 OKVary: Accept-EncodingContent-Type: application/jsonStrict-Transport-Security: max-age=300Date: {dateInUnixFormat}Connection: keep-aliveContent-Length: {requestLengthInBytes}X-MongoDB-Service-Version: gitHash={gitHash}; versionString={ApplicationVersion}

Corpo de resposta

1{2  "desc" : "test",3  "id" : "{API-KEY-ID}",4  "links" : [ {5    "href" : "https://cloud.mongodb.com/api/public/v1.0/orgs/{ORG-ID}/apiKeys/{API-KEY-ID}",6    "rel" : "self"7  } ],8  "privateKey" : "********-****-****-1493e7bcfde9",9  "publicKey" : "{PUBLIC-KEY}",10  "roles" : [ {11    "groupId" : "{PROJECT-ID-1}",12    "roleName" : "GROUP_DATA_ACCESS_READ_WRITE"13  }, {14    "groupId" : "{PROJECT-ID-1}",15    "roleName" : "GROUP_READ_ONLY"16  }, {17    "groupId" : "{PROJECT-ID-2}",18    "roleName" : "GROUP_READ_ONLY"19  }, {20    "orgId" : "{ORG-ID}",21    "roleName" : "ORG_MEMBER"22  } ]23}

Voltar

Criar e atribuir

Modificar funções