Descrição
Ative um grupo de usuários inativo. A ativação é uma ação dedicada e não um campo, então o estado active não pode ser alterado por PUT | Atualizar grupo de usuários ou PATCH | Atualizar parcialmente grupo de usuários.
Uma atualização enviada a um grupo inativo é recusada com 409 api.resource.inactive, então ative o grupo antes quando precisar editá-lo.
Pré-requisitos
- Uma aplicação com a autorização Users concedida pelo administrador no A2A. Para mais informações, acesse Como gerenciar autorizações no A2A API v2.
- Um token de acesso OAuth 2.0 válido. Para mais informações, acesse Como autenticar uma aplicação A2A.
Requisição
POST /api/v2/iam/user-groups/{id}/activate
Esta ação não recebe corpo de requisição.
Parâmetros de path
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
id |
integer | Sim | Código de identificação único do grupo de usuários. |
Exemplo de requisição
POST {{url}}/api/v2/iam/user-groups/7/activate
Resposta
HTTP/1.1 204 No Content
X-Request-Id: 7f3c1a90-2c4e-4b1a-9f5e-0a2b7c9d1e34
Uma ativação bem-sucedida não retorna corpo. Para confirmar o novo estado, acesse GET | Consultar um grupo de usuários.
A ativação não restaura os vínculos de membro. Desativar ou excluir um grupo remove todos os seus membros, então adicione-os novamente após a ativação. Para mais informações, acesse POST | Adicionar membros a um grupo de usuários.
Erros
| Código HTTP | Mensagem | Possível causa | Solução |
|---|---|---|---|
401 |
api.auth.unauthorized |
O token de acesso está ausente, inválido ou expirou. | Solicite um novo token de acesso. |
404 |
api.resource.not_found |
O grupo de usuários não existe, ou está fora do escopo da autorização. | Verifique o código de identificação e o escopo da autorização. |
409 |
api.resource.conflict.already_active |
O grupo de usuários já está ativo. | Nenhuma ação é necessária. |
429 |
api.rate_limit_exceeded |
O limite de requisições foi excedido. | Aguarde o número de segundos retornado no cabeçalho Retry-After e tente novamente. |
Para as mensagens de erro de autenticação e a política de 403 versus 404, acesse API v2 - Convenções e comportamentos compartilhados.