Importante:
Aviso prévio de uma alteração futura
A Cloud Services Platform (CSP) oferecerá suporte à autenticação Proof Key for Code Exchange (PKCE) e cancelará a autenticação não PKCE. Se você for um usuário de API do VMware Aria Automation e tiver uma Política de Autorização de IP configurada em uma organização do cliente usando o CSP, precisará obter o token de atualização seguindo a API do CSP documentada em Obter token de acesso por token de atualização de API. O token obtido seguindo o endpoint de login da API IaaS documentado em Obter seu token de acesso será preterido.
Quando a data de lançamento dessa alteração for conhecida, esse aviso será atualizado.
Aviso: As Notas da versão das versões anteriores são arquivadas anualmente:
A documentação da API está disponível com o produto. Para acessar todos os documentos do Swagger em uma única página de aterrissagem, acesse:
-
https://www.mgmt.cloud.vmware.com/automation-ui/api-docs/ para o vRealize Automation Cloud.
-
https://<appliance.domain.com>/automation-ui/api-docs para o vRealize Automation 8.x, em que appliance.domain.com é o dispositivo vRealize Automation.
Antes de usar a API, considere as atualizações mais recentes da API e as alterações desta versão e anote todas as alterações nos serviços de API que você utiliza. Se você nunca bloqueou sua API usando a variável apiVersion, talvez se depare com uma alteração em uma resposta dessa API. Todas as atualizações e alterações de APIs são fornecidas na seção Novidades de cada lançamento.
Para APIs desbloqueadas, o comportamento padrão varia dependendo da API.
-
Para as APIs IaaS do Cloud Assembly, todas as solicitações que forem executadas sem o parâmetro apiVersion serão redirecionadas à primeira versão, que é 2019-01-15. Esse redirecionamento permitirá que cada usuário que não tenha especificado anteriormente o parâmetro apiVersion passe sem problemas para a versão mais recente sem sofrer alterações com interrupções.
OBSERVAÇÃO: Para as APIs IaaS do Cloud Assembly, a versão mais recente é apiVersion = 2021-07-15. Se o bloqueio não for feito, as solicitações de APIs IaaS serão redirecionadas para a primeira versão, que é 2019-01-15. A primeira versão está obsoleta e terá suporte por 24 meses. Para garantir uma transição suave para a nova versão, bloqueie suas solicitações de APIs IaaS com o parâmetro apiVersion atribuído a 2021-07-15.
-
Para outras APIs, suas solicitações de API serão padronizadas para a versão mais recente. Se você selecionar uma das datas de versão anteriores listadas para a especificação do Swagger, o comportamento da API refletirá as APIs que estavam em vigor a partir dessa data e em qualquer data até a próxima data da versão mais recente. APIs não têm controle de versão para cada lançamento do vRealize Automation, e nem todas elas oferecem suporte ao parâmetro apiVersion.
Para obter mais informações sobre como usar o parâmetro apiVersion, consulte os Guias de Programação listados em:
As atualizações e alterações da API para cada versão são abordadas nas seguintes seções: