Exemplo 2: criação de um gateway de cliente
Cenário
Esta seção descreve como criar um gateway de cliente chamando APIs.
Pré-requisitos
- Você obteve um token de usuário se precisar usar a autenticação de token. Além disso, você precisa adicionar X-Auth-Token ao cabeçalho da solicitação ao chamar uma API. Para obter detalhes sobre autenticação de token, consulte Autenticação.

O token obtido pelo IAM é válido por apenas 24 horas. Ao usar um token para autenticação, armazene-o em cache para evitar chamadas frequentes.
Preparação de dados
Parâmetro |
Descrição |
Exemplo de valor |
---|---|---|
name |
Especifica um nome de gateway de cliente. |
stub-customer-gateway-id-1 |
route_mode |
Especifica o modo de roteamento do gateway. |
static |
ip |
Especifica o endereço IP do gateway de cliente. |
10.12.13.21 |
Procedimento
- Crie um gateway de cliente.
- Envie POST https://{endpoint}/v5/{project_id}/customer-gateways.
- Adicione X-Auth-Token ao cabeçalho da solicitação.
- Especifique os seguintes parâmetros no corpo da solicitação:
{ "customer_gateway": { "name": "cgw-3ebf", "route_mode": "static", "ip": "10.***.***.21" } }
- Verifique a resposta.
- A solicitação será bem-sucedida se a seguinte resposta for exibida. Na resposta, id indica um ID de gateway de cliente.
1 2 3 4 5 6 7 8 9 10 11
{ "customer_gateway": { "id": "03c0aa3d-****-****-****-9d82473765d4", "name": "cgw-3ebf", "route_mode": "static", "ip": "10.***.***.21", "created_at": "2021-12-21T16:49:28.108+08:00", "updated_at": "2021-12-21T16:49:28.108+08:00" }, "request_id": "e55783ba-5cc8-40c1-ad81-12cce6f773d2" }
- A solicitação será bem-sucedida se a seguinte resposta for exibida. Na resposta, id indica um ID de gateway de cliente.
- Consulte detalhes sobre o gateway de cliente.
- Envie GET https://{endpoint}/v5/{project_id}/customer-gateways/{customer_gateway_id}.
- Adicione X-Auth-Token ao cabeçalho da solicitação.
- Verifique a resposta.
- A solicitação será bem-sucedida se a seguinte resposta for exibida. Na resposta, id indica um ID de gateway de cliente.
1 2 3 4 5 6 7 8 9 10 11
{ "customer_gateway": { "id": "03c0aa3d-****-****-****-9d82473765d4", "name": "cgw-3ebf", "route_mode": "static", "ip": "10.***.***.21", "created_at": "2021-12-21T16:49:28.108+08:00", "updated_at": "2021-12-21T16:49:28.108+08:00" }, "request_id": "8cf476c4-c3d4-4516-bfbc-01e2473e549b" }
- A solicitação será bem-sucedida se a seguinte resposta for exibida. Na resposta, id indica um ID de gateway de cliente.