A API de limite ajuda a criar, configurar e monitorar as configurações de limite.
Método | Caminho | Descrição |
---|---|---|
POST | list/endpointConfigs | Obter uma lista das configurações de limite de endpoint |
POST | /endpointConfigs | Criar uma configuração de limite de endpoint |
POST | /endpointConfigs/{uid} /deploy |
Implantar uma configuração de limite de ponto de extremidade |
POST | /endpointConfigs/{uid} /undeploy |
Desimplantar uma configuração de limite de endpoint |
POST | /endpointConfigs/{uid} /canDeploy |
Verificar se uma configuração de limite de ponto de extremidade pode ser implantada ou não |
PUT | /endpointConfigs/{uid} |
Atualizar uma configuração de limite de ponto de extremidade |
GET | /endpointConfigs/{uid} |
Recuperar uma configuração de limite de ponto de extremidade |
DELETE | /endpointConfigs/{uid} |
Excluir uma configuração de limite de ponto de extremidade |
Quando uma configuração é criada ou atualizada, uma verificação é executada automaticamente para garantir a sintaxe e a integridade do payload.
Se ocorrerem alguns problemas, a operação retornará um aviso ou erros para ajudá-lo a corrigir a configuração.
Esta é a estrutura básica de uma configuração de endpoint:
{
"url": "<endpoint URL>", //wildcards are allowed in the endpoint URL
"methods": [ "<HTTP method such as GET, POST, >, ...],
"services": {
"<service name>": { . //must be "action" or "dataSource"
"maxHttpConnections": <max connections count to the endpoint>
"rating": {
"maxCallsCount": <max calls to be performed in the period defined by period/timeUnit>,
"periodInMs": <integer value greater than 0>
}
},
...
}
}
`{
"url": "https://api.example.org/data/2.5/*",
"methods": [
"GET"
],
"services": {
"dataSource": {
"maxHttpConnections": 30000,
"rating": {
"maxCallsCount": 5000,
"periodInMs": 1000
}
}
},
"orgId": "<IMS Org Id>"
}
Quando um canDeploy for chamado, o processo validará a configuração e retornará o status de validação identificado por seu identificador exclusivo:
"ok" or "error"
Os possíveis erros são:
<!--<given value>-->
: deve ser "dataSource" ou "action"O aviso potencial é:
ERR_ENDPOINTCONFIG_106: configuração de limitação: máximo de conexões HTTP não definidas: sem limitação por padrão
Nesta seção, você encontrará os cinco principais casos de uso que podem ser executados para gerenciar a configuração de limite no Journey Orchestration.
Para ajudá-lo nos testes e configurações, uma coleção do Postman está disponível aqui.
Esta coleção do Postman foi estabelecida como um complemento da coleção variável do Postman gerada pela opção Integrações do console do Adobe I/O > Experimente > Baixar para o Postman, que gera um arquivo de ambiente do Postman com os valores das integrações selecionadas.
Após o download e o upload para o Postman, é necessário adicionar três variáveis: {JO_HOST}
,{BASE_PATH}
e {SANDBOX_NAME}
.
{JO_HOST}
: URL de gateway do Journey Orchestration{BASE_PATH}
: ponto de entrada da API. O valor é “/authoring”{SANDBOX_NAME}
: o cabeçalho x-sandbox-name (por exemplo, “prod”) correspondente ao nome da sandbox na qual as operações da API ocorrerão. Consulte a visão geral das sandboxes para obter mais informações.Na seção a seguir, você encontrará a lista ordenada de chamadas API REST para executar o caso de uso.
Caso de utilização n.º 1: Criação e implantação de uma nova configuração de limite
Caso de uso n.º 2: Atualizar e implantar uma configuração de limite ainda não implantada
Caso de utilização n.º 3: Desimplantar e excluir uma configuração de limite implantada
Caso de uso n.º 4: Excluir uma configuração de limite implantada.
Em apenas uma chamada de API, é possível desimplantar e excluir a configuração com o uso do parâmetro forceDelete.
Caso de utilização n.º 5: Atualizar uma configuração de limite já implantada