Adição ou exclusão de registros da lista branca em lote de um serviço do VPC Endpoint
Função
Função Essa API é usada para adicionar em lote listas brancas de serviços do ponto de extremidade da VPC. A descrição pode ser adicionada. Observação: sua conta está na lista branca do seu próprio serviço do ponto de extremidade da VPC por padrão.
URI
POST /v1/{project_id}/vpc-endpoint-services/{vpc_endpoint_service_id}/permissions/batch-create
|
Parâmetro |
Obrigatoriedade |
Tipo |
Descrição |
|---|---|---|---|
|
project_id |
Sim |
String |
Especifica o ID do projeto. Mínimo: 1 Máximo: 64 |
|
vpc_endpoint_service_id |
Sim |
String |
Especifica o ID do serviço do ponto de extremidade da VPC. Mínimo: 1 Máximo: 64 |
Parâmetros de solicitação
|
Parâmetro |
Obrigatoriedade |
Tipo |
Descrição |
|---|---|---|---|
|
X-Auth-Token |
Sim |
String |
Especifica o token do usuário. Ele pode ser obtido chamando a API do IAM. O valor de X-Subject-Token no cabeçalho da resposta é o token do usuário. Mínimo: 1 Máximo: 2048 |
|
Content-Type |
Sim |
String |
Especifica o tipo MIME do corpo da solicitação. O valor padrão application/json é recomendado. Para as API usadas para carregar objetos ou imagens, o tipo MIME pode variar dependendo do tipo de fluxo. Mínimo: 1 Máximo: 65 |
|
Parâmetro |
Obrigatoriedade |
Tipo |
Descrição |
|---|---|---|---|
|
Permissões |
Sim |
Array of EpsAddPermissionRequest objects |
Especifica os registros da lista branca de um serviço do ponto de extremidade da VPC. |
|
Parâmetro |
Obrigatoriedade |
Tipo |
Descrição |
|---|---|---|---|
|
permission |
Sim |
String |
O formato de permissão é iam:domain::domain_id. ● iam:domínio:: é um formato fixo. ● domain_id é o ID da conta do usuário que pode ser conectado. O valor contém de 1 a 64 caracteres, incluindo letras e dígitos. O valor também pode ser um asterisco (*).
Mínimo: 1 Máximo: 64 |
|
description |
Sim |
String |
Especifica a descrição de um registro de lista branca de um serviço do ponto de extremidade da VPC. |
Parâmetros de resposta
Código de estado: 200
|
Parâmetro |
Tipo |
Descrição |
|---|---|---|
|
permissions |
Array of EpsPermission objects |
Especifica o corpo da resposta de um registro de lista branca de um serviço do ponto de extremidade da VPC. |
|
Parâmetro |
Tipo |
Descrição |
|---|---|---|
|
id |
String |
Especifica os IDs de chave primária dos registros da lista de permissões de um serviço do ponto de extremidade da VPC. |
|
permission |
String |
O formato de permissão é iam:domain::domain_id. ● iam:domínio:: é um formato fixo. ● domain_id é o ID da conta do usuário que pode ser conectado. O valor contém de 1 a 64 caracteres, incluindo letras e dígitos. O valor também pode ser um asterisco (*).
Mínimo: 1 Máximo: 64 |
|
description |
String |
Especifica a descrição de um registro de lista branca de um serviço do ponto de extremidade da VPC. |
|
created_at |
String |
Especifica a hora em que um registro de lista branca é criado. |
Código de estado: 400
|
Parâmetro |
Tipo |
Descrição |
|---|---|---|
|
error |
Error object |
Especifica a mensagem de erro retornada quando ocorre uma exceção de envio de tarefa. |
|
Parâmetro |
Tipo |
Descrição |
|---|---|---|
|
message |
String |
Descrição do erro da tarefa |
|
code |
String |
Código de erro de uma exceção de tarefa. |
Código de estado: 401
|
Parâmetro |
Tipo |
Descrição |
|---|---|---|
|
error |
Error object |
Especifica a mensagem de erro retornada quando ocorre uma exceção de envio de tarefa. |
|
Parâmetro |
Tipo |
Descrição |
|---|---|---|
|
message |
String |
Descrição do erro da tarefa |
|
code |
String |
Código de erro de uma exceção de tarefa. |
Código de estado: 403
|
Parâmetro |
Tipo |
Descrição |
|---|---|---|
|
error |
Error object |
Especifica a mensagem de erro retornada quando ocorre uma exceção de envio de tarefa. |
|
Parâmetro |
Tipo |
Descrição |
|---|---|---|
|
message |
String |
Descrição do erro da tarefa |
|
code |
String |
Código de erro de uma exceção de tarefa. |
Código de estado: 404
|
Parâmetro |
Tipo |
Descrição |
|---|---|---|
|
error |
Error object |
Especifica a mensagem de erro retornada quando ocorre uma exceção de envio de tarefa. |
|
Parâmetro |
Tipo |
Descrição |
|---|---|---|
|
message |
String |
Descrição do erro da tarefa |
|
code |
String |
Código de erro de uma exceção de tarefa. |
Código de estado: 405
|
Parâmetro |
Tipo |
Descrição |
|---|---|---|
|
error |
Error object |
Especifica a mensagem de erro retornada quando ocorre uma exceção de envio de tarefa. |
|
Parâmetro |
Tipo |
Descrição |
|---|---|---|
|
message |
String |
Descrição do erro da tarefa |
|
code |
String |
Código de erro de uma exceção de tarefa. |
Código de estado: 406
|
Parâmetro |
Tipo |
Descrição |
|---|---|---|
|
error |
Error object |
Especifica a mensagem de erro retornada quando ocorre uma exceção de envio de tarefa. |
|
Parâmetro |
Tipo |
Descrição |
|---|---|---|
|
message |
String |
Descrição do erro da tarefa |
|
code |
String |
Código de erro de uma exceção de tarefa. |
Código de estado: 407
|
Parâmetro |
Tipo |
Descrição |
|---|---|---|
|
error |
Error object |
Especifica a mensagem de erro retornada quando ocorre uma exceção de envio de tarefa. |
|
Parâmetro |
Tipo |
Descrição |
|---|---|---|
|
message |
String |
Descrição do erro da tarefa |
|
code |
String |
Código de erro de uma exceção de tarefa. |
Código de estado: 408
|
Parâmetro |
Tipo |
Descrição |
|---|---|---|
|
error |
Error object |
Especifica a mensagem de erro retornada quando ocorre uma exceção de envio de tarefa. |
|
Parâmetro |
Tipo |
Descrição |
|---|---|---|
|
message |
String |
Descrição do erro da tarefa |
|
code |
String |
Código de erro de uma exceção de tarefa. |
Código de estado: 409
|
Parâmetro |
Tipo |
Descrição |
|---|---|---|
|
error |
Error object |
Especifica a mensagem de erro retornada quando ocorre uma exceção de envio de tarefa. |
|
Parâmetro |
Tipo |
Descrição |
|---|---|---|
|
message |
String |
Descrição do erro da tarefa |
|
code |
String |
Código de erro de uma exceção de tarefa. |
Código de estado: 500
|
Parâmetro |
Tipo |
Descrição |
|---|---|---|
|
error |
Error object |
Especifica a mensagem de erro retornada quando ocorre uma exceção de envio de tarefa. |
|
Parâmetro |
Tipo |
Descrição |
|---|---|---|
|
message |
String |
Descrição do erro da tarefa |
|
code |
String |
Código de erro de uma exceção de tarefa. |
Código de estado: 501
|
Parâmetro |
Tipo |
Descrição |
|---|---|---|
|
error |
Error object |
Especifica a mensagem de erro retornada quando ocorre uma exceção de envio de tarefa. |
|
Parâmetro |
Tipo |
Descrição |
|---|---|---|
|
message |
String |
Descrição do erro da tarefa |
|
code |
String |
Código de erro de uma exceção de tarefa. |
Código de estado: 502
|
Parâmetro |
Tipo |
Descrição |
|---|---|---|
|
error |
Error object |
Especifica a mensagem de erro retornada quando ocorre uma exceção de envio de tarefa. |
|
Parâmetro |
Tipo |
Descrição |
|---|---|---|
|
message |
String |
Descrição do erro da tarefa |
|
code |
String |
Código de erro de uma exceção de tarefa. |
Código de estado: 503
|
Parâmetro |
Tipo |
Descrição |
|---|---|---|
|
error |
Error object |
Especifica a mensagem de erro retornada quando ocorre uma exceção de envio de tarefa. |
|
Parâmetro |
Tipo |
Descrição |
|---|---|---|
|
message |
String |
Descrição do erro da tarefa |
|
code |
String |
Código de erro de uma exceção de tarefa. |
Código de estado: 504
|
Parâmetro |
Tipo |
Descrição |
|---|---|---|
|
error |
Error object |
Especifica a mensagem de erro retornada quando ocorre uma exceção de envio de tarefa. |
|
Parâmetro |
Tipo |
Descrição |
|---|---|---|
|
message |
String |
Descrição do erro da tarefa |
|
code |
String |
Código de erro de uma exceção de tarefa. |
Exemplo de solicitações
Adicionar registros da lista branca de um serviço do ponto de extremidade da VPC
POST https://{endpoint}/v1/{project_id}/vpc-endpoint-services/c07132bf-4071-439a-9ff3-2068eb45092f/permissions/batch-create { "permissions" : [ { "permission" : "*", "description" : "Specifies APIs for batch adding whitelist records of a VPC endpoint service." }, { "permission" : "iam:domain::4dbb0ce8766f44a9bfd08ccf8fc02397", "description" : "test" } ] }
Exemplo de respostas
Código de estado: 200
O servidor processou a solicitação com sucesso.
{ "permissions" : [ { "id" : "ab42a58b-6f8e-43b3-9400-aaf0e393ee0d", "permission" : "iam:domain::4dbb0ce8766f44a9bfd08ccf8fc02397", "description" : "test", "created_at" : "2022-06-16T10:03:27Z" }, { "id" : "dfaaeff1-858d-4631-83c4-be3548a07935", "permission" : "*", "description" : "", "created_at" : "2022-06-16T10:03:27Z" } ] }
Códigos de estado
|
Código de estado |
Descrição |
|---|---|
|
200 |
O servidor processou a solicitação com sucesso. |
|
400 |
O servidor não conseguiu processar a solicitação. |
|
401 |
Nome de usuário e senha são necessários para acessar a página solicitada. |
|
403 |
O acesso à página solicitada é proibido. |
|
404 |
O servidor não pôde encontrar a página solicitada. |
|
405 |
O método especificado na requisição não é permitido. |
|
406 |
A resposta gerada pelo servidor não pôde ser aceita pelo cliente. |
|
407 |
A autenticação de proxy é necessária antes que a solicitação seja processada. |
|
408 |
A solicitação expirou o tempo limite. |
|
409 |
A solicitação não pôde ser processada devido a um conflito. |
|
500 |
Falhou na solicitação. Ocorreu um erro de serviço. |
|
501 |
Falhou na solicitação. O servidor não suporta a função solicitada. |
|
502 |
Falhou na solicitação. O servidor recebeu uma resposta inválida do servidor upstream. |
|
503 |
Falhou na solicitação. O sistema não está disponível. |
|
504 |
Gateway expirou o tempo limite. |
Códigos de erro
Consulte Códigos de erro.