Este conteúdo foi traduzido por máquina para sua conveniência e a Huawei Cloud não pode garantir que o conteúdo foi traduzido com precisão. Para exibir o conteúdo original, use o link no canto superior direito para mudar para a página em inglês.
Central de ajuda> API Gateway> Referência de API> APIs de gateway dedicadas (V2)> Gerenciamento de grupos de APIs> Criação de um grupo de API
Atualizado em 2023-05-29 GMT+08:00
Ver PDF

Criação de um grupo de API

Função

Esta API é usada para criar um grupo da API. Um grupo da API é uma unidade de gerenciamento de API e a entrada para um serviço. Um nome de subdomínio é retornado como a entrada de acesso quando um grupo da API é criado. As APIs em um grupo da API devem ser correlacionadas entre si.

URI

POST /v2/{project_id}/apigw/instances/{instance_id}/api-groups

Tabela 1 Parâmetros de caminho

Parâmetro

Obrigatório

Tipo

Descrição

project_id

Sim

String

ID do projeto. Para obter detalhes sobre como obter um ID de projeto, consulte "Apêndice" > "Obtenção de um ID de projeto" neste documento.

instance_id

Sim

String

ID do gateway, que pode ser obtido a partir das informações de gateway no console do APIG.

Parâmetros de solicitação

Tabela 2 Parâmetros do cabeçalho de solicitação

Parâmetro

Obrigatório

Tipo

Descrição

X-Auth-Token

Sim

String

Token do usuário. Ele pode ser obtido chamando a API do IAM usada para obter um token de usuário. O valor de X-Subject-Token no cabeçalho da resposta é um token.
Tabela 3 Parâmetros de corpo de solicitação

Parâmetro

Obrigatório

Tipo

Descrição

name

Sim

String

Nome do grupo de APIs.

O valor pode conter de 3 a 255 caracteres, incluindo letras, dígitos e caracteres especiais (-_./():). Deve começar com uma letra ou dígito.

Mínimo: 3

Máximo: 255

remark

Não

String

Descrição do grupo de API.

Máximo: 1000

roma_app_id

Não

String

ID da aplicação de integração ao qual o grupo de APIs pertence.

Este parâmetro é necessário quando a versão do grupo é V2.

Atualmente, este parâmetro não é suportado.

version

Não

String

Versão do grupo.

  • V1: grupo global
  • V2: grupo no nível da aplicação

O valor padrão é V1. Este parâmetro não é suportado atualmente.

Parâmetros de resposta

Código de status: 201

Tabela 4 Parâmetros de corpo de resposta

Parâmetro

Tipo

Descrição

id

String

ID.

name

String

Nome do grupo de APIs.

status

Integer

Status.

  • 1: válido

Valores de enumeração:

  • 1

sl_domain

String

Nome do subdomínio que o APIG aloca automaticamente ao grupo da API.

register_time

String

Tempo de criação.

update_time

String

Hora da última modificação.

on_sell_status

Integer

Indica se o grupo de APIs foi listado no KooGallery.

  • 1: listado
  • 2: não listado
  • 3: em revisão

url_domains

Array of UrlDomain objects

Nomes de domínio independentes vinculados ao grupo de APIs.

sl_domains

Array of strings

Nomes de subdomínio alocados automaticamente.

remark

String

Descrição.

call_limits

Integer

Número total de vezes que todas as APIs no grupo da API podem ser acessadas. Considere a capacidade de carga útil do serviço de back-end ao definir esse parâmetro. Por padrão, não há limite no número de chamadas de API.

Atualmente, este parâmetro não é suportado.

time_interval

Integer

Período de tempo para limitar o número de chamadas de API.

Atualmente, este parâmetro não é suportado.

time_unit

String

Unidade de tempo para limitar o número de chamadas de API.

Atualmente, este parâmetro não é suportado.

is_default

Integer

Indica se o grupo de API é o grupo padrão.

version

String

Versão do grupo.

  • V1: grupo global
  • V2: grupo no nível da aplicação

O valor padrão é V1. Este parâmetro não é suportado atualmente.

roma_app_id

String

ID da aplicação de integração ao qual o grupo de APIs pertence.

Este parâmetro é necessário quando a versão do grupo é V2.

Atualmente, este parâmetro não é suportado.

roma_app_name

String

Nome da aplicação de integração ao qual o grupo de APIs pertence.

Atualmente, este parâmetro não é suportado.
Tabela 5 UrlDomain

Parâmetro

Tipo

Descrição

id

String

ID do domínio.

domain

String

Nome de domínio.

cname_status

Integer

Status de resolução CNAME do nome de domínio.

  • 1: não resolvido
  • 2: resolvendo
  • 3: resolvido
  • 4: resolução falhou

ssl_id

String

ID do certificado SSL.

ssl_name

String

Nome do certificado SSL.

min_ssl_version

String

Versão SSL mínima. TLS 1.1 e TLS 1.2 são suportados.

Padrão: TLSv1.1

Valores de enumeração:

  • TLSv1.1
  • TLSv1.2

Código de status: 400

Tabela 6 Parâmetros de corpo de resposta

Parâmetro

Tipo

Descrição

error_code

String

Código de erro.

error_msg

String

Mensagem de erro.

Código de status: 401

Tabela 7 Parâmetros de corpo de resposta

Parâmetro

Tipo

Descrição

error_code

String

Código de erro.

error_msg

String

Mensagem de erro.

Código de status: 403

Tabela 8 Parâmetros de corpo de resposta

Parâmetro

Tipo

Descrição

error_code

String

Código de erro.

error_msg

String

Mensagem de erro.

Código de status: 500

Tabela 9 Parâmetros de corpo de resposta

Parâmetro

Tipo

Descrição

error_code

String

Código de erro.

error_msg

String

Mensagem de erro.

Exemplo de solicitações

{
  "name" : "api_group_001",
  "remark" : "API group 1"
}

Exemplo de respostas

Código de status: 201

Criado

{
  "update_time" : "2020-07-31T06:55:55.383169299Z",
  "name" : "api_group_001",
  "on_sell_status" : 2,
  "remark" : "API group 1",
  "sl_domains" : [ "c77f5e81d9cb4424bf704ef2b0ac7600.apic.****.com", "c77f5e81d9cb4424bf704ef2b0ac7600.apic.****.cn" ],
  "sl_domain" : "c77f5e81d9cb4424bf704ef2b0ac7600.apic.****.com",
  "id" : "c77f5e81d9cb4424bf704ef2b0ac7600",
  "register_time" : "2020-07-31T06:55:55.383169068Z",
  "status" : 1,
  "is_default" : 2
}

Código de status: 400

Solicitação inválida

{
  "error_code" : "APIG.2011",
  "error_msg" : "Invalid parameter value,parameterName:name. Please refer to the support documentation"
}

Código de status: 401

Não autorizado

{
  "error_code" : "APIG.1002",
  "error_msg" : "Incorrect token or token resolution failed"
}

Código de status: 403

Proibido

{
  "error_code" : "APIG.1005",
  "error_msg" : "No permissions to request this method"
}

Código de status: 500

Erro do servidor interno

{
  "error_code" : "APIG.9999",
  "error_msg" : "System error"
}

Códigos de status

Código de status

Descrição

201

Criado

400

Solicitação inválida

401

Não autorizado

403

Proibido

500

Erro do servidor interno

Códigos de erro

Consulte Códigos de erro.

Tópico principal: Gerenciamento de grupos de APIs