n Automation 7 - docs.vmware.com€¦ · vRealize Automation 7 Função do vRealize Orchestrator com o plug-in do vRealize Automation 7 2 Configurando o plug-in do vRealize Automation

Usando o plug-in do vRealizeOrchestrator para vRealize Automation

7.3vRealize Orchestrator 7.3vRealize Automation 7.3vRealize Automation 7.3

Usando o plug-in do vRealize Orchestrator para vRealize Automation 7.3

2 VMware, Inc.

Você pode encontrar a documentação técnica mais atualizada no site da VMware, em:

https://docs.vmware.com/br/

O site da VMware também fornece as atualizações mais recentes de produtos.

Caso tenha comentários sobre esta documentação, envie seu feedback para:

[email protected]

Copyright © 2012–2017 VMware, Inc. Todos os direitos reservados. Informações de direitos autorais e marcas registradas.

VMware, Inc.3401 Hillview Ave.Palo Alto, CA 94304www.vmware.com

https://docs.vmware.com/br/

mailto:[email protected]

http://pubs.vmware.com/copyright-trademark.html

Conteúdo

Usando o plug-in do vRealize Orchestrator para o vRealize Automation 5

1 Introdução ao plug-in do VMware vRealize Orchestrator para

vRealize Automation 7Função do vRealize Orchestrator com o plug-in do vRealize Automation 7

2 Configurando o plug-in do vRealize Automation 9

Fluxos de trabalho de configuração 9Adicionar um host do vRealize Automation 10Adicionar um host IaaS 11

3 Usando os fluxos de trabalho de plug-in do vRealize Automation 13

Remover restrições de operação 13Operações restritas 14

Usando o inventário de plug-ins do vRealize Automation 15Usando os fluxos de trabalho de administração de plug-in do vRealize Automation 16Usando os fluxos de trabalho de administração da infraestrutura de plug-ins do

vRealize Automation 22Criar uma entidade de modelo IaaS do vRealize Automation 24Ler uma entidade de modelo IaaS do vRealize Automation 25

Usando os fluxos de trabalho de solicitações de plug-in do vRealize Automation 25Usando os fluxos de trabalho de amostra de plug-in do vRealize Automation 26Acessar a API de plug-in do vRealize Automation 27

4 Exemplo de scripts de plug-in do vRealize Automation 29

Scripts de exemplos de tarefas de administração da infraestrutura de CRUD 29Localizando scripts de exemplos de entidades do vRealize Automation 33Obter um recurso fornecido por um script de exemplo do vRealize Automation 34Scripts de exemplos de tarefas comuns 35

Índice 39

VMware, Inc. 3


4 VMware, Inc.

Usando o plug-in do vRealize Orchestrator parao vRealize Automation

Usando o plug-in do vRealize Orchestrator para o vRealize Automation fornece informações e instruções sobrecomo configurar e usar o plug-in do VMware® vRealize Orchestrator para o VMware vRealize Automation.

Público-alvoAs informações em Usando o plug-in do vRealize Orchestrator para o vRealize Automation foram concebidas parausuários experientes que estão familiarizados com a tecnologia de máquina virtual, com o desenvolvimentode fluxos de trabalho do Orchestrator e com o VMware vRealize Automation.

Para obter mais informações sobre o Orchestrator, consulte http://www.vmware.com/support/pubs/orchestrator_pubs.html.

Para obter mais informações sobre o vRealize Automation, consulte http://www.vmware.com/support/pubs/vrealize-automation.html.

Glossário de publicações técnicas da VMwareO documento Publicações técnicas da VMware fornece um glossário de termos que podem não serfamiliares para você. Para conhecer definições de termos usados na documentação técnica da VMware,acesse http://www.vmware.com/support/pubs.

VMware, Inc. 5

http://www.vmware.com/support/pubs/orchestrator_pubs.html

http://www.vmware.com/support/pubs/vrealize-automation.html

http://www.vmware.com/support/pubs


6 VMware, Inc.

Introdução ao plug-in do VMwarevRealize Orchestrator paravRealize Automation 1

O plug-in do VMware vRealize Orchestrator para vRealize Automation permite a interação entre ovRealize Orchestrator e o vRealize Automation.

Você pode usar o plug-in do vRealize Automation para criar e executar fluxos de trabalho para as seguintesfunções do vRealize Automation:

n Gerenciamento de blueprints e recursos personalizados do XaaS

n Gerenciamento e solicitação de recursos e itens de catálogo

n Configuração de direitos

n Configuração de políticas de aprovação

n Interações de itens de trabalho

n Ações de provisionamento e pós-provisionamento de máquinas virtuais do vSphere e do vCloudDirector

n Operações CRUD (criar, ler, atualizar e excluir) no modelo IaaS do vRealize Automation

Função do vRealize Orchestrator com o plug-in dovRealize Automation

Você usa o cliente do Orchestrator para executar e criar fluxos de trabalho e acessar a API do plug-in. Vocêpode usar a instância incorporada do vRealize Orchestrator na sua instalação do vRealize Automation ouum servidor do vRealize Orchestrator externo.

O vRealize Orchestrator alimenta o plug-in do vRealize Automation. O vRealize Orchestrator é umaplataforma de desenvolvimento e automação de processos que fornece uma biblioteca de fluxos de trabalhoextensíveis para gerenciar a pilha de nuvem do VMware e tecnologias de terceiros.

O vRealize Orchestrator permite a integração com soluções de gerenciamento e administração por meio desua arquitetura de plug-ins aberta.

VMware, Inc. 7


8 VMware, Inc.

Configurando o plug-in dovRealize Automation 2

Você adiciona hosts do vRealize Automation e hosts do IaaS para configurar o plug-in.

Fluxos de trabalho de configuraçãoVocê pode usar os fluxos de trabalho nas categorias de fluxo de trabalho de Configuração para gerenciarhosts do vRealize Automation.

Hosts do vRealize AutomationEstes fluxos de trabalho podem ser acessados na exibição Fluxos de Trabalho do cliente do Orchestrator, nosubdiretório Configuração da biblioteca de plug-ins.

Nome do fluxo de trabalho Descrição

Adicionar um host do vRA Adiciona um host do vRealize Automation ao inventário de plug-ins. Para tarefas degerenciamento e administração de tenants, é possível usar a exibição Inventário paraexecutar fluxos de trabalho em cada tenant. Para usar a função completa do plug-inpara um tenant, crie um host do vRealize Automation dedicado para cada tenant.

Adicionar um host do vRAusando o registro decomponentes

Adiciona um host do vRealize Automation ao inventário de plug-ins com umaconexão Por Sessão de Usuário. Você deve estar conectado ao cliente do Orchestratorcom as credenciais do administrador de sistema do vRealize Automation.Para usar essa função com um servidor do vRealize Orchestrator externo, você deveregistrar o servidor do Orchestrator no registro de componentes dovRealize Automation.

Adicionar o host do IaaS de umhost do vRA

Adiciona o host do IaaS do host do vRealize Automation selecionado ao inventário deplug-ins.

Remover um host do vRA Remove um host do vRealize Automation do inventário de plug-ins.

Atualizar um host do vRA Atualiza um host do vRealize Automation no inventário de plug-ins.

Validar um host do vRA Valida o host do vRealize Automation e a conexão com ele.

Observação Se o seu servidor vRealize Orchestrator estiver registrado no registro do componentes dovRealize Automation, um host do vRealize Automation com o nome Padrão será adicionadoautomaticamente. O host Padrão está usando a conexão Por Sessão de Usuário com o tenant padrão. Oservidor do Orchestrator incorporado na instalação do vRealize Automation está registrado no registro docomponentes do vRealize Automation por padrão.

Hosts do IaaS vRealize AutomationEstes fluxos de trabalho podem ser acessados na exibição Fluxos de Trabalho do cliente do Orchestrator, nosubdiretório Administração de Infraestrutura > Configuração da biblioteca de plug-ins.

VMware, Inc. 9

O servidor do vRealize Orchestrator incorporado na instalação do vRealize Automation está registrado noregistro do componentes do vRealize Automation por padrão.


Adicionar um host do IaaS Adiciona um host do IaaS vRealize Automation ao inventário de plug-ins. Em termosfuncionais, esse fluxo de trabalho é igual a Adicionar o host do IaaS de um host do vRA,mas não requer um host do vRealize Automation.

Remover um host do IaaS Remove um host do IaaS vRealize Automation do inventário de plug-ins.

Atualizar um host do IaaS Atualiza um host do IaaS vRealize Automation no inventário de plug-ins.

Validar um host do IaaS Valida o host do IaaS vRealize Automation e a conexão com ele.

Adicionar um host do vRealize AutomationVocê pode executar um fluxo de trabalho para adicionar um host vRealize Automation e configurar osparâmetros de conexão desse host.

Procedimentos

1 No menu suspenso do cliente do Orchestrator, selecione Executar ou Design.

2 Clique na exibição Fluxos de Trabalho.

3 Expanda Biblioteca > vRealize Automation > Configuração.

4 Clique com o botão direito do mouse no fluxo de trabalho Adicionar um host vRA e selecione Iniciarfluxo de trabalho.

5 Insira um nome exclusivo para o host na caixa de texto Nome do host.

6 Insira o endereço de URL do host na caixa de texto URL do host.

Por exemplo: https://nome_host.

7 Insira o nome do tenant na caixa de texto Tenant.

Para usar a funcionalidade completa do plug-in para um tenant, crie um host do vRealize Automationdedicado para cada tenant.

8 Selecione se você deseja instalar os certificados SSL automaticamente sem a confirmação do usuário.

9 (Opcional) Para configurar por quanto tempo o vRealize Orchestrator aguarda uma conexão ou umaresposta do vRealize Automation, insira intervalos de tempo limite nas caixas de texto Tempo limite daconexão (segundos) e Tempo limite da operação (segundos).

10 Selecione o tipo de conexão com o host no menu suspenso Modo da sessão.

Opção Ações

Sessão Compartilhada Insira as credenciais para um usuário do vRealize Automation nas caixasde texto Nome do usuário de autenticação e Senha de autenticação.

Por Sessão de Usuário Conecte-se usando as credenciais do usuário que está conectado nomomento. Você deve estar conectado ao cliente do Orchestrator com ascredenciais do administrador de sistema do vRealize Automation.Para usar essa opção com um servidor do vRealize Orchestrator externo,você deve registrar o servidor do Orchestrator no registro de componentesdo vRealize Automation.

11 Clique em Enviar.

Próximo passo

Adicione um host de Administração de Infraestrutura do vRealize Automation.


10 VMware, Inc.

Adicionar um host IaaSVocê pode executar um fluxo de trabalho para adicionar o host IaaS de um host vRealize Automation econfigurar os parâmetros de conexão.

Procedimentos



3 Expanda Biblioteca > vRealize Automation > Administração de Infraestrutura > Configuração.

4 Clique com o botão direito do mouse em Adicionar um host IaaS e selecione Iniciar fluxo de trabalho.

5 Selecione o host do vRealize Automation para o qual você deseja configurar um host IaaS no menususpenso Host vCAC.

6 Insira um nome exclusivo para o host na caixa de texto Nome do host.

7 Insira a URL da máquina na qual o Model Manager está instalado.

Por exemplo: https://máquina_model_manager.com.

8 Para instalar os certificados SSL, selecione Sim.

9 Para usar um proxy para acessar a máquina do Model Manager, selecione Sim.

Se você selecionar essa opção, deverá fornecer o host do proxy e a porta do proxy na página a seguir.

10 Clique em Avançar.

11 Se estiver configurando um proxy explícito, forneça a URL e a porta do host do proxy.


13 Para configurar seus próprios valores de tempo limite, clique em Não.

14 (Opcional) Para configurar por quanto tempo o vRealize Orchestrator aguarda uma conexão ou umaresposta do vRealize Automation, insira intervalos de tempo limite nas caixas de texto Tempo limite daconexão (segundos) e Tempo limite da operação (segundos).


16 Selecione o tipo de autenticação do host.

Opção Descrição

SSO Selecione essa opção para usar o vCenter Single Sign-On.

NTLM Selecione essa opção para ativar a autenticação com base em protocolo NTLAN Manager (NTLM) apenas se a sua infraestrutura do Active Directorydepender da autenticação NTLM.Se você selecionar essa opção, deverá especificar as credenciais NTLM e asopções de autenticação adicionais.

17 Se você selecionou NTLM, clique em Avançar e insira o nome da máquina da estação de trabalho e o

nome do domínio NetBIOS.

18 Clique em Enviar.

Capítulo 2 Configurando o plug-in do vRealize Automation

VMware, Inc. 11


12 VMware, Inc.

Usando os fluxos de trabalho deplug-in do vRealize Automation 3

A biblioteca de fluxos de trabalho de plug-in do vRealize Automation contém fluxos de trabalho que vocêpode usar para tarefas comuns, como interagir com o catálogo, gerenciar a infraestrutura e criar tenants eserviços.

Você pode usar cabeçalhos HTTP personalizados, como os cabeçalhos Tarefas e Identidade específicos dovRealize Automation, e aplicá-los nos fluxos de trabalho de CRUD, provisionamento e pós-provisionamento.

Este capítulo inclui os seguintes tópicos:

n “Remover restrições de operação”, na página 13

n “Usando o inventário de plug-ins do vRealize Automation”, na página 15

n “Usando os fluxos de trabalho de administração de plug-in do vRealize Automation”, na página 16

n “Usando os fluxos de trabalho de administração da infraestrutura de plug-ins do vRealizeAutomation”, na página 22

n “Usando os fluxos de trabalho de solicitações de plug-in do vRealize Automation”, na página 25

n “Usando os fluxos de trabalho de amostra de plug-in do vRealize Automation”, na página 26

n “Acessar a API de plug-in do vRealize Automation”, na página 27

Remover restrições de operaçãoAlgumas operações de criação, leitura, atualização e exclusão são restritas a partir da versão 7.0. Se vocêusava essas operações em seus fluxos de trabalho de versões anteriores, elas não funcionarão com as versões7.0 e posteriores. É possível atualizar seus fluxos de trabalho para as operações com suporte ou reativar asoperações necessárias.

Para reativar as operações, você deve remover aquelas que deseja ativar no arquivo operations.properties.Para obter uma lista das operações no arquivo, consulte “Operações restritas”, na página 14.

Procedimentos

1 No menu suspenso do vRealize Orchestrator, selecione Projetar.

2 Clique na exibição Recursos.

3 Na hierarquia de recursos, expanda Biblioteca > VCAC > Util.

4 Crie um backup e modifique o arquivo operations.properties.

a Clique com o botão direito do mouse em operations.properties e selecione Salvar no arquivo.

b Salve uma cópia como backup.

VMware, Inc. 13

c Crie uma nova cópia e exclua as operações que deseja reativar.

d Salve o novo arquivo.

5 Substitua o arquivo existente no vRealize Orchestrator.

a No vRealize Orchestrator, clique com o botão direito do mouse na pasta Util e clique em Importarrecursos.

b Navegue até a nova versão do arquivo operations.properties e clique em Abrir.

c Clique em Substituir uma vez para salvar sua versão modificada.

6 Reinicie o servidor do vRealize Orchestrator.

7 Selecione o arquivo operations.properties e clique na guia Visualizador.

8 Verifique se as operações que você está habilitando não estão mais no arquivo.

As operações que você removeu do arquivo agora funcionam nos seus fluxos de trabalho mais antigos.

Próximo passo

Ao criar novos fluxos de trabalho, evite usar as operações restritas.

Operações restritasO conteúdo do arquivo operations.properties contém as operações restritas. Para reativar a operação, vocêdeve removê-la do arquivo.

O texto a seguir é a versão padrão do arquivo operations.properties. Para reativar uma operação, consulte “Remover restrições de operação”, na página 13.

#Blueprints

operation.create=ManagementModelEntities.svc@VirtualMachineTemplates

operation.update=ManagementModelEntities.svc@VirtualMachineTemplates

operation.delete=ManagementModelEntities.svc@VirtualMachineTemplates

#Blueprint properties

operation.create=ManagementModelEntities.svc@VirtualMachineProperties

operation.read=ManagementModelEntities.svc@VirtualMachineProperties

operation.update=ManagementModelEntities.svc@VirtualMachineProperties

operation.delete=ManagementModelEntities.svc@VirtualMachineProperties

#Global profiles

operation.create=ManagementModelEntities.svc@GlobalProfiles

operation.read=ManagementModelEntities.svc@GlobalProfiles

operation.update=ManagementModelEntities.svc@GlobalProfiles

operation.delete=ManagementModelEntities.svc@GlobalProfiles

#Global profile properties

operation.create=ManagementModelEntities.svc@GlobalProfileProperties

operation.read=ManagementModelEntities.svc@GlobalProfileProperties

operation.update=ManagementModelEntities.svc@GlobalProfileProperties

operation.delete=ManagementModelEntities.svc@GlobalProfileProperties

#PropertySetXml

operation.create=ManagementModelEntities.svc@PropertySetXml

operation.read=ManagementModelEntities.svc@PropertySetXml

operation.update=ManagementModelEntities.svc@PropertySetXml

operation.delete=ManagementModelEntities.svc@PropertySetXml

#Property definitions

operation.create=ManagementModelEntities.svc@PropertyDefinitions

operation.read=ManagementModelEntities.svc@PropertyDefinitions

operation.update=ManagementModelEntities.svc@PropertyDefinitions


14 VMware, Inc.

operation.delete=ManagementModelEntities.svc@PropertyDefinitions

#Property attributes

operation.create=ManagementModelEntities.svc@PropertyAttributes

operation.read=ManagementModelEntities.svc@PropertyAttributes

operation.update=ManagementModelEntities.svc@PropertyAttributes

operation.delete=ManagementModelEntities.svc@PropertyAttributes

#Property Attribute Types

operation.create=ManagementModelEntities.svc@PropertyAttributeTypes

operation.read=ManagementModelEntities.svc@PropertyAttributeTypes

operation.update=ManagementModelEntities.svc@PropertyAttributeTypes

operation.delete=ManagementModelEntities.svc@PropertyAttributeTypes

#Control layouts

operation.create=ManagementModelEntities.svc@ControlLayouts

operation.read=ManagementModelEntities.svc@ControlLayouts

operation.update=ManagementModelEntities.svc@ControlLayouts

operation.delete=ManagementModelEntities.svc@ControlLayouts

#Amazon Virtual Machine Templates

operation.create=AmazonWSModelEntities.svc@AmazonVirtualMachineTemplates

operation.read=AmazonWSModelEntities.svc@AmazonVirtualMachineTemplates

operation.update=AmazonWSModelEntities.svc@AmazonVirtualMachineTemplates

operation.delete=AmazonWSModelEntities.svc@AmazonVirtualMachineTemplates

#Openstack Virtual Machine Templates

operation.create=OpenStackModelEntities.svc@OpenstackVirtualMachineTemplates

operation.read=OpenStackModelEntities.svc@OpenstackVirtualMachineTemplates

operation.update=OpenStackModelEntities.svc@OpenstackVirtualMachineTemplates

operation.delete=OpenStackModelEntities.svc@OpenstackVirtualMachineTemplates

#Endpoint credentials

operation.create=ManagementModelEntities.svc@ConnectionCredentials

operation.update=ManagementModelEntities.svc@ConnectionCredentials

operation.delete=ManagementModelEntities.svc@ConnectionCredentials

#Management endpoints

operation.create=ManagementModelEntities.svc@ManagementEndpoints

operation.update=ManagementModelEntities.svc@ManagementEndpoints

operation.delete=ManagementModelEntities.svc@ManagementEndpoints

#Management endpoint properties

operation.create=ManagementModelEntities.svc@ManagementEndpointProperties

operation.read=ManagementModelEntities.svc@ManagementEndpointProperties

operation.update=ManagementModelEntities.svc@ManagementEndpointProperties

operation.delete=ManagementModelEntities.svc@ManagementEndpointProperties

Usando o inventário de plug-ins do vRealize AutomationVocê pode usar a exibição Inventário para executar fluxos de trabalho em objetos do vRealize Automation.

Para exibir os fluxos de trabalho que estão disponíveis para um objeto de inventário, vá até Ferramentas >Preferências do Usuário > Inventário e marque a caixa de seleção Usar menu contextual no inventário.Depois que a opção for habilitada, quando você clicar com o botão direito do mouse em um objeto noinventário do Orchestrator, serão exibidos todos os fluxos de trabalho disponíveis para esse objeto.

Capítulo 3 Usando os fluxos de trabalho de plug-in do vRealize Automation

VMware, Inc. 15

Usando os fluxos de trabalho de administração de plug-in dovRealize Automation

Você pode usar os fluxos de trabalho de administração para gerenciar serviços do vRealize Automation,tenants, políticas de aprovação, direitos, grupos de negócios, itens de catálogo e componentes de ServiçosAvançados.

Alguns dos fluxos de trabalho incluem um parâmetro de entrada para o host do vRealize Automation,vCACCAFE:VCACHost. A maneira como você configurou a conexão do host do vRealize Automation determinacomo as funções serão aplicadas quando um usuário executar os fluxos de trabalho.

n Se você tiver configurado a conexão como uma sessão compartilhada, a conta de usuário dessa sessãocompartilhada deverá ter as funções necessárias para executar os fluxos de trabalho.

n Se você tiver configurado a conexão como uma sessão por usuário, cada usuário que executar os fluxosde trabalho deverá ter as funções necessárias, exatamente como teriam na interface de usuário dovRealize Automation.

Esses fluxos de trabalho estão localizados na exibição Fluxo de Trabalho do cliente dovRealize Orchestrator, no subdiretório Biblioteca > vRealize Automation > Administração.

É possível usar os fluxos de trabalho no subdiretório Políticas de Aprovação para criar e gerenciar políticasde aprovação.

Tabela 3‑1. Políticas de aprovação

Fluxo de trabalho Descrição

Ativar uma política de aprovação Ativa uma política de aprovação. Depois de ativada, umapolítica de aprovação torna-se somente leitura.

Adicionar um nível de aprovação Adiciona um nível de aprovação sempre necessário parauma aprovação. Você deve selecionar usuários e gruposespecíficos para os aprovadores.

Copiar uma política de aprovação Copia uma política de aprovação.

Criar uma política de aprovação Cria uma política de aprovação de rascunho sem níveis ouaprovadores. Para criar níveis de aprovação e designaraprovadores para a sua política, execute o fluxo de trabalhoAdicionar um nível de aprovação.

Desativar uma política de aprovação Desativa uma política de aprovação. Você também podeexcluir todos os direitos existentes associados à política deaprovação.

Excluir uma política de aprovação Exclui uma política de aprovação que está em estado derascunho. As políticas de aprovação ativas são somenteleitura.

É possível usar os fluxos de trabalho no subdiretório Grupos de Negócios para criar e gerenciar grupos denegócios e propriedades personalizadas de grupos de negócios.

Tabela 3‑2. Grupos de negócios


Adicionar uma propriedade personalizada Adiciona uma propriedade personalizada a um grupo denegócios.

Criar um grupo de negócios Cria um grupo de negócios.

Excluir um grupo de negócios Exclui um grupo de negócios.

Excluir uma propriedade personalizada Remove uma propriedade personalizada de um grupo denegócios.


16 VMware, Inc.

Tabela 3‑2. Grupos de negócios (Continuação)


Atualizar um grupo de negócios Atualiza detalhes de um grupo de negócios, como o prefixode máquina padrão, os contêineres do Active Directory e asfunções de usuário.

Atualizar uma propriedade personalizada Atualiza uma propriedade personalizada para um grupode negócios.

O subdiretório Administração inclui um subdiretório Grupos de Negócios (Obsoleto) que funciona com asversões anteriores ao vRealize Automation 7.0. Use os fluxos de trabalho com o mesmo nome na pastaprincipal.

É possível usar os fluxos de trabalho no subdiretório Itens de Catálogo para gerenciar itens de catálogo.

Tabela 3‑3. Itens de catálogo


Ativar um item de catálogo Ativa um item de catálogo. Você deve ativar e atribuir umitem de catálogo a um serviço antes que os usuáriospossam solicitá-lo.

Atribuir um item de catálogo a um serviço Atribui um item de catálogo a um serviço. Você deve ativare atribuir um item de catálogo a um serviço antes que osusuários possam solicitá-lo.

Desativar um item de catálogo Desativa um item de catálogo e o remove do catálogo deserviços, para que os usuários não possam solicitá-lo.

É possível usar os fluxos de trabalho no subdiretório Blueprint Composto para gerenciar blueprintscompostos criados na tela de criação.

Tabela 3‑4. Blueprint Composto


Excluir um blueprint composto Exclui um formulário de blueprint não publicado da listaBlueprints de design.

Importar um blueprint composto Importa um blueprint composto de um arquivo YAML.

Publicar um blueprint composto Publica um blueprint composto que está em estado derascunho.

Cancelar a publicação de um blueprint composto Cancela a publicação de um blueprint composto publicado.

Os fluxos de trabalho do subdiretório Conteúdo estão obsoletos. Use o Cloud Client para realizar as açõesde importação e exportação. O download e a documentação do Cloud Client estão disponíveis no https://developercenter.vmware.com/tool/cloudclient.

Tabela 3‑5. Conteúdo


Exportar conteúdo (obsoleto) Use o Cloud Client para realizar as ações de importação eexportação. O download e a documentação do CloudClient estão disponíveis no https://developercenter.vmware.com/tool/cloudclient.

Importar conteúdo (obsoleto) Use o Cloud Client para realizar as ações de importação eexportação. O download e a documentação do CloudClient estão disponíveis no https://developercenter.vmware.com/tool/cloudclient.


VMware, Inc. 17

https://developercenter.vmware.com/tool/cloudclient



Tabela 3‑5. Conteúdo (Continuação)


Transferir conteúdo (obsoleto) Use o Cloud Client para realizar as ações de importação eexportação. O download e a documentação do CloudClient estão disponíveis no https://developercenter.vmware.com/tool/cloudclient.

Validar conteúdo (obsoleto) Use o Cloud Client para realizar as ações de importação eexportação. O download e a documentação do CloudClient estão disponíveis no https://developercenter.vmware.com/tool/cloudclient.

É possível usar os fluxos de trabalho no subdiretório Direitos para criar e gerenciar direitos.

Tabela 3‑6. Direitos


Ativar um direito Ativa um direito.

Atribuir itens de catálogo a um direito Atribui um ou mais itens de catálogo a um direito. Vocêtambém pode usar esse fluxo de trabalho para atribuir umapolítica de aprovação.

Atribuir ações imediatas a um direito Atribui uma ou mais ações imediatas a um direito. Asações imediatas não criam solicitações.

Atribuir ações de recursos a um direito Atribui uma ou mais ações de recursos a um direito. Vocêtambém pode usar esse fluxo de trabalho para atribuir umapolítica de aprovação.

Atribuir serviços a um direito Atribui um ou mais serviços a um direito. Você tambémpode usar esse fluxo de trabalho para atribuir uma políticade aprovação.

Atribuir usuários e grupos a um direito Atribui um ou mais usuários ou grupos a um direito.

Criar um direito (obsoleto) Cria um direito. Use Criar um direito para subtenant.

Criar um direito para subtenant Cria um direito.

Desativar um direito Desativa um direito.

Cancelar a atribuição de usuários e grupos a um direito Remove usuários e grupos da lista de usuários de umdireito.

É possível usar os fluxos de trabalho no subdiretório Propriedades para gerenciar definições depropriedades e grupos de propriedades. Para evitar conflito com as propriedades do vRealize Automation,use um prefixo como um nome de empresa ou recurso seguido de um ponto para todos os nomes depropriedades personalizadas.

Tabela 3‑7. Definições de propriedades


Criar definição de propriedade Cria uma propriedade personalizada.

Excluir definição de propriedade Exclui uma propriedade personalizada.

Grupos de propriedades são coleções de definições de propriedades.


18 VMware, Inc.



Tabela 3‑8. Grupos de propriedades


Adicionar propriedade ao grupo Adiciona uma propriedade personalizada definida a umgrupo.

Criar grupo de propriedades Cria um grupo de propriedades ao qual você podeadicionar propriedades personalizadas definidas.

Excluir grupo de propriedades Exclui o grupo de propriedades.

Remover propriedades do grupo Remove uma propriedade personalizada definida de umgrupo de propriedades.

Atualizar grupo de propriedades Modifica o nome ou a descrição do grupo de propriedades.

Atualizar propriedade no grupo Modifica o nome, o valor e o comportamento dapropriedade no grupo de propriedades.

É possível usar os fluxos de trabalho no subdiretório Serviços para gerenciar serviços.

Tabela 3‑9. Serviços


Ativar um serviço Ativa um serviço.

Atribuir itens de catálogo a um serviço Atribui um ou mais itens de catálogo a um serviço.

Copiar um serviço Copia um serviço.

Criar um serviço Cria um serviço.

Desativar um serviço Desativa um serviço.

Excluir um serviço Exclui um serviço.

É possível usar os fluxos de trabalho no subdiretório Tenants para criar e gerenciar tenants.

Os fluxos de trabalho de repositório de identificação estão obsoletos. Os fluxos de trabalho de substituiçãotrabalham com as alterações no vRealize Automation para a API do Directories Management.

Tabela 3‑10. Tenants


Adicionar administradores Adiciona um ou mais administradores de tenants eadministradores de infraestrutura a um tenant.

Adicionar um repositório de identidades a um tenant Adiciona um repositório de identidades a um tenant de umhost do vRealize Automation. Você apenas poderá executaresse fluxo de trabalho se for um administrador de sistemaconfigurando um tenant.

Adicionar um repositório de identidades a um tenant(obsoleto)

Use o fluxo de trabalho Adicionar um repositório deidentidades a um tenant.

Adicionar um repositório de identidades a um host dovCAC

Adiciona um repositório de identidades a um tenant queestá configurado como um host do vRealize Automation.Você apenas poderá executar esse fluxo de trabalho se forum administrador de tenants configurando um repositóriode identidades para o seu tenant.

Adicionar um repositório de identidades a um host dovCAC (Deprecated)

Use o fluxo de trabalho Adicionar um repositório deidentidades a um host do vCAC.

Criar um tenant Cria um tenant. Você deve selecionar o host dovRealize Automation adicionado com as credenciais deadministrador de sistema.


VMware, Inc. 19

Tabela 3‑10. Tenants (Continuação)


Excluir um repositório de identidades de um tenant Exclui um repositório de identidades de um tenant de umhost do vRealize Automation. Você apenas poderá executaresse fluxo de trabalho se for um administrador de sistemaconfigurando um tenant.

Excluir um repositório de identidades de um host dovCAC

Exclui um repositório de identidades de um tenant que estáconfigurado como um host do vRealize Automation. Vocêapenas poderá executar esse fluxo de trabalho se for umadministrador de tenants configurando repositórios deidentidades para o seu tenant.

Excluir um tenant Exclui um tenant.

Remover administradores Remove um ou mais administradores de tenants eadministradores de infraestrutura de um tenant.

Atualizar um repositório de identidades para um tenant Atualiza um repositório de identidades existente para umtenant de um host do vRealize Automation. Você apenaspoderá executar esse fluxo de trabalho se for umadministrador de sistema configurando um tenant.

Atualizar um repositório de identidades para um tenant(obsoleto)

Use o fluxo de trabalho Atualizar um repositório deidentidades para um tenant.

Atualizar um repositório de identidades para um host dovCAC

Atualiza um repositório de identidades para um tenant queestá configurado como um host do vRealize Automation.Você apenas poderá executar esse fluxo de trabalho se forum administrador de tenants configurando repositórios deidentidades para o seu tenant.

Atualizar um repositório de identidades para um host dovCAC (obsoleto)

Use o fluxo de trabalho Atualizar um repositório deidentidades para um host do vCAC.

Atualizar um tenant Atualiza o nome, a descrição e o endereço de e-mail decontato de um tenant existente.

É possível usar os fluxos de trabalho no subdiretório Inscrições de Fluxo de Trabalho para gerenciar asinscrições de fluxo de trabalho de eventos.

Tabela 3‑11. Inscrições de fluxo de trabalho


Excluir uma inscrição de fluxo de trabalho Exclui uma inscrição de fluxo de trabalho não publicada.Esse fluxo de trabalho aplica-se a inscrições de fluxo detrabalho do sistema e de tenants.

Exportar inscrição de fluxo de trabalho do sistema Exporta uma inscrição de fluxo de trabalho do sistema e asalva como um elemento de recurso dovRealize Orchestrator no formato JSON.Uma inscrição de fluxo de trabalho do sistema é umainscrição de fluxo de trabalho especializada que reage aeventos do sistema e a eventos em todos os tenants.

Exportar inscrição de fluxo de trabalho de tenants Exporta uma inscrição de fluxo de trabalho de tenants e asalva como um elemento de recurso no formato JSON.Uma inscrição de fluxo de trabalho especializada queexecuta fluxos de trabalho específicos de tenants.

Importar inscrição de fluxo de trabalho do sistema Importa uma inscrição de fluxo de trabalho do sistema deum arquivo JSON. Inscrições de fluxo de trabalho dosistema são acionadas por eventos do sistema e podemocorrer entre tenants.

Importar inscrição de fluxo de trabalho de tenants Importa uma inscrição de fluxo de trabalho exportada deum arquivo JSON. Essas inscrições de fluxo de trabalho sãoespecíficas de tenants.


20 VMware, Inc.

Tabela 3‑11. Inscrições de fluxo de trabalho (Continuação)


Publicar uma inscrição de fluxo de trabalho Publica uma inscrição de fluxo de trabalho que estava emestado de rascunho ou não publicado. Esse fluxo detrabalho aplica-se a inscrições de fluxo de trabalho dosistema e de tenants.

Registrar uma inscrição de fluxo de trabalho do sistema Cria uma inscrição de fluxo de trabalho do sistema,incluindo valores de tempo limite e prioridade.

Registrar uma inscrição de fluxo de trabalho de tenants Cria uma inscrição de fluxo de trabalho específica detenants, incluindo valores de tempo limite e prioridade.

Cancelar a publicação de uma inscrição de fluxo detrabalho

Cancela a publicação de uma inscrição de fluxo de trabalhopublicada. Esse fluxo de trabalho aplica-se a inscrições defluxo de trabalho do sistema e de tenants.

Atualizar uma inscrição de fluxo de trabalho Altere o nome, a descrição, o fluxo de trabalho dovRealize Orchestrator, as condições de inscrição, o valor detempo limite, o valor de status e o valor de prioridade. Nãoé possível atualizar o tópico de evento ou o estado debloqueio.

É possível usar os fluxos de trabalho no subdiretório Recursos Personalizados do XaaS para criar egerenciar recursos personalizados do XaaS.

Tabela 3‑12. Recursos Personalizados do XaaS


Criar recurso personalizado Cria um recurso personalizado.

Excluir recurso personalizado Remove um recurso personalizado.

É possível usar os fluxos de trabalho no subdiretório Ações de Recursos do XaaS para criar e gerenciarações de recursos do XaaS.

Tabela 3‑13. Ações de Recursos do XaaS


Clonar ação de recurso Cria uma cópia de uma ação de recurso existente.

Criar ação de recurso Cria uma ação de recurso.

Excluir ação de recurso Exclui uma ação de recurso.

Publicar ação de recurso Publica uma ação de recurso.

Cancelar publicação de ação de recurso Cancelar a publicação de uma ação de recurso.

É possível usar os fluxos de trabalho no subdiretório Mapeamentos de Recursos do XaaS para criar egerenciar mapeamentos XaaS para recursos que não são do XaaS.

Tabela 3‑14. Mapeamentos de recursos do XaaS


Criar um mapeamento de recurso Mapeia um tipo de recurso de catálogo para um tipo dovRealize Orchestrator.

Excluir um mapeamento de recurso Exclui um mapeamento de recurso.

Definir um critério de destino Especifica as condições que determinam a disponibilidadedo mapeamento de recurso.

É possível usar os fluxos de trabalho no subdiretório Configuração do Servidor XaaS para gerenciar ainstância do Orchestrator de destino.


VMware, Inc. 21

Tabela 3‑15. Configuração do Servidor XaaS


Atualizar configuração do servidor do Orchestrator Modifica as configurações do servidor, incluindo a porta, ohost, o nome de usuário e a senha.

Validar configuração do servidor do Orchestrator Verifica se as configurações do vRealize Orchestrator sãoválidas. O fluxo de trabalho retornará um valor TRUE se aconfiguração for válida e FALSE se a configuração não forválida.

É possível usar os fluxos de trabalho no subdiretório Blueprints de Serviço XaaS para criar e gerenciarblueprints XaaS.

Tabela 3‑16. Blueprints do XaaS


Clonar um blueprint de serviço Cria uma cópia de um blueprint de serviço.

Criar um blueprint de serviço Cria um blueprint de serviço.

Excluir um blueprint de serviço Exclui um blueprint de serviço.

Publicar um blueprint de serviço Publica um blueprint de serviço.

Cancelar a publicação de um blueprint de serviço Cancela a publicação de um blueprint de serviço.

Usando os fluxos de trabalho de administração da infraestrutura deplug-ins do vRealize Automation

Você pode usar os fluxos de trabalho de administração da infraestrutura para executar operações básicas.Use o pacote de extensibilidade para personalizar o vRealize Automation com a capacidade de chamarfluxos de trabalho do vRealize Orchestrator como parte do processo de provisionamento ou usando menusde operação personalizados.

Os fluxos de trabalho de administração da infraestrutura estão localizados na exibição Fluxos de Trabalhodo cliente do Orchestrator, no subdiretório Administração da Infraestrutura da biblioteca de plug-ins.

Você pode usar esses fluxos de trabalho para provisionar máquinas virtuais e executar operações básicas decriação, leitura, atualização ou exclusão.


22 VMware, Inc.

Tabela 3‑17. Administração da infraestrutura


Aguardar alteração de estado da máquina virtual Aguarda uma alteração de estado para um conjunto demáquinas virtuais. Se todas as máquinas virtuais estiveremem estado de êxito, um gatilho será chamado, e o fluxo detrabalho terminará com sucesso. Se qualquer uma dasmáquinas virtuais especificadas entrar em estado de falha,ou não existir, o fluxo de trabalho falhará. Você deve inseriros estados de êxito e falha selecionando uma das seguintesopções:n Requested

n AwaitingApproval

n RegisterMachine

n BuildingMachine

n AddingDisks

n MachineProvisioned

n MachineActivated

n InstallTools (somente VMware)n On

n Off

n TurningOn

n TurningOff

n ShuttingDown

n Suspending

n Resetting

n Rebooting

n Expired

n DeactivateMachine

n UnprovisionMachine

n Disposing

n Finalized

Criar uma entidade de modelo do IaaS Cria uma entidade e a mantém persistente para um modeloespecificado do vRealize Automation.

Excluir uma entidade de modelo do IaaS Exclui uma entidade de modelo do vRealize Automationespecificada.

Invocar uma ação pós-provisionamento (obsoleto) Use o fluxo de trabalho Solicitar uma ação de recurso.

Provisionar uma máquina virtual de um blueprint(removido no vRealize Automation 7.0)

Substituído por Solicitar um item de catálogo ou Solicitarum item de catálogo com solicitação de provisionamento.

Ler uma entidade IaaS por filtro personalizado Lê uma lista de entidades do vRealize Automation usandoum filtro personalizado. Se você não especificar um filtro,todas as entidades serão retornadas como resultado.

Ler uma entidade IaaS por consulta do sistema Lê uma lista de entidades do vRealize Automation usandofiltros do sistema OData. Os filtros do sistema aplicam-se àconvenção de URI OData.

Ler uma entidade de modelo do IaaS Lê uma entidade de modelo do vRealize Automation porseu ID.

Atualizar uma entidade de modelo do IaaS Atualiza uma entidade de modelo do vRealize Automationpor seu ID.

Use os fluxos de trabalho no subdiretório Extensibilidade para personalizar o vRealize Automation com acapacidade de chamar fluxos de trabalho do vRealize Orchestrator como parte do processo deprovisionamento ou por menus de operação personalizados.


VMware, Inc. 23

O subdiretório também inclui fluxos de trabalho para gerenciar credenciais, endpoints, grupos empresariais,prefixos de máquina e outras entidades do IaaS.

Tabela 3‑18. Extensibilidade


Instalar personalização do vCO Instala uma personalização do Orchestrator, incluindofluxos de trabalho de alteração de estado e fluxos detrabalho de operações de menu personalizados.

Desinstalar personalização do vCO Desinstala uma personalização do Orchestrator, incluindofluxos de trabalho de alteração de estado e fluxos detrabalho de operações de menu personalizados.

Alterar reserva de uma máquina virtual IaaS Altera os atributos, como reservas e grupos de negócios, deuma máquina virtual gerenciada.

Importar uma máquina virtual IaaS (obsoleto) Use o Cloud Client. O download e a documentação doCloud Client estão disponíveis no https://developercenter.vmware.com/tool/cloudclient.

Importar máquina virtual do vCenter (obsoleto) Use o Cloud Client. O download e a documentação doCloud Client estão disponíveis no https://developercenter.vmware.com/tool/cloudclient.

Cancelar o registro da máquina virtual (removido novRealize Automation 7.0)

Nenhum fluxo de trabalho de substituição é fornecido.

Atribuir uma operação de menu a um blueprint e suasmáquinas virtuais (obsoleto)

Adiciona ou atualiza uma operação de menu em máquinasvirtuais.Fluxos de trabalho alternativos e não obsoletos incluemAtribuir ações de recurso a um direito e Importar umblueprint composto.

Atribuir uma operação de menu a máquinas virtuais(obsoleto)

Atualiza uma entidade de modelo do vRealize Automationpor seu ID.Fluxos de trabalho alternativos e não obsoletos incluemAtribuir ações de recurso a um direito e Importar umblueprint composto.

Atribuir um fluxo de trabalho de alteração de estado a umblueprint e suas máquinas virtuais (obsoleto)

Substituído por inscrições de agentes de eventos novRealize Automation.

Personalizar uma operação de menu (removido novRealize Automation 7.0)


Remover uma operação de menu de um blueprint e suasmáquinas virtuais (removido no vRealize Automation 7.0)


Remover um fluxo de trabalho de alteração de estado deum blueprint e suas máquinas virtuais

Remove um fluxo de trabalho de alteração de estado de umblueprint e suas máquinas virtuais.

Criar uma entidade de modelo IaaS do vRealize AutomationVocê pode executar um fluxo de trabalho para criar uma entidade IaaS do vRealize Automation simples oucomplexa, como uma referência de máquina virtual para um usuário.

Procedimentos



3 Expanda Biblioteca > vRealize Automation > Administração de Infraestrutura.

4 Clique com o botão direito do mouse no fluxo de trabalho Criar uma entidade de modelo IaaS eselecione Iniciar fluxo de trabalho.


24 VMware, Inc.



5 Selecione um host vRealize Automation.

6 Insira o nome do modelo na caixa de texto Nome do modelo.

7 Insira o nome do conjunto de entidades na caixa de texto Nome do conjunto de entidades.

Você usa scripts ou uma API REST para definir as propriedades Simples, Links para propriedadescomplexas e propriedades de cabeçalhos HTTP.

8 Clique em Enviar para executar o fluxo de trabalho.

Ler uma entidade de modelo IaaS do vRealize AutomationVocê pode executar um fluxo de trabalho para ler uma entidade de modelo IaaS do vRealize Automation.

Procedimentos



3 Expanda Biblioteca > vRealize Automation > Administração de Infraestrutura.

4 Clique com o botão direito do mouse em Ler uma entidade de modelo IaaS e selecione Iniciar fluxo detrabalho.

5 Selecione um host vRealize Automation.

6 Insira o nome do modelo na caixa de texto Nome do modelo.

7 Insira o nome do conjunto de entidades na caixa de texto Nome do conjunto de entidades.

Você usa scripts ou uma API REST para definir a propriedade de cabeçalhos HTTP.

8 Clique em Enviar para executar o fluxo de trabalho.

Usando os fluxos de trabalho de solicitações de plug-in dovRealize Automation

É possível usar os fluxos de trabalho de solicitações para solicitar itens de catálogo e ações de recursos e paraconcluir ou cancelar itens de trabalho.

Um item de trabalho requer entrada ou ação do usuário. Por exemplo, um fluxo de trabalho de interação,ação de aprovação ou resposta a uma solicitação de recuperação.

Esses fluxos de trabalho podem ser acessados na exibição Fluxos de Trabalho do cliente dovRealize Orchestrator, no subdiretório Solicitações da biblioteca de plug-ins.

Fluxo detrabalho Descrição

Cancelar umitem de trabalho

Cancela um item de trabalho ativo. Você apenas poderá usar esse fluxo de trabalho se você for um administrador de sistema.

Concluir umitem de trabalho

Finaliza um item de trabalho com base na entrada fornecida pelo usuário.

Solicitar umitem de catálogo

Solicita um item de catálogo para o usuário que executa o fluxo de trabalho.Se você precisar de um fluxo de trabalho para solicitar um blueprint composto, use o fluxo de trabalho Solicitar um catálogo comsolicitação de provisionamento.

Solicitar umitem de catálogoem nome de umusuário

Envia uma solicitação para um item de catálogo em nome de um usuário. É possível usar esse fluxo de trabalho apenas para itens decatálogo autorizados para você e para o usuário em nome do qual você está enviando a solicitação.


VMware, Inc. 25

Fluxo detrabalho Descrição

Solicitar umcatálogo comsolicitação deprovisionamento

Solicita um blueprint composto como um item de catálogo para o usuário que executa o fluxo de trabalho. Se você estiver fornecendouma entrada personalizada para a solicitação, deverá personalizar o fluxo de trabalho. Use esse fluxo de trabalho para blueprintscompostos.

Solicitar umaação de recurso

Solicita uma ação de recurso para um item de catálogo que pertence ao usuário que executa o fluxo de trabalho.

Solicitar umaação de recursoem nome de umusuário

Envia uma solicitação para uma ação de recurso em nome de um usuário. É possível usar esse fluxo de trabalho apenas para ações derecurso autorizadas para você e para o usuário em nome do qual você está enviando a solicitação.

Solicitar umaação de recursocom um modelode solicitação

Solicita uma ação de recurso que inclui parâmetros complexos. A prática recomendada é duplicar o fluxo de trabalho e, em seguida,personalizá-lo para a ação. É possível usar esse fluxo de trabalho para transmitir parâmetros complexos ou ocultos que você não desejaque apareçam no formulário de solicitação. Uma das principais aplicações desse fluxo de trabalho é para personalizar a ação IaaS dereconfiguração de máquina virtual.Para criar uma operação de reconfiguração em uma máquina virtual, você deve criar uma cópia do fluxo de trabalho e, em seguida,modificar o script. Configure os parâmetros que aparecem no vRealize Orchestrator e defina o parâmetroCafe.Shim.VirtualMachine.Reconfigure.Requestor. Esse parâmetro é usado para registro e não deve estar vazio. Consulte oexemplo a seguir.var requestTemplate = vCACCAFERequestsHelper.getRequestForResourceAction(operation)

var jsonData = vCACCAFERequestsHelper.getResourceActionRequestData(requestTemplate);var json = JSON.parse(jsonData);//Change cpu examplejson.cpu = 2;

//This is a property needed for the Reconfigure IaaS operation:json["Cafe.Shim.VirtualMachine.Reconfigure.Requestor"] = 1;vCACCAFERequestsHelper.setResourceActionRequestData(requestTemplate, JSON.stringify(json));

request = System.getModule("com.vmware.library.vcaccafe.request").requestResourceActionWithRequestTemplate(operation, requestTemplate);

Aguardar umasolicitação deitem de catálogo

Aguarda a conclusão de uma solicitação de item de catálogo.

Aguardar umasolicitação deação de recurso

Aguarda a conclusão de uma solicitação de ação de recurso.

Aguardar umitem de trabalho

Aguarda a conclusão de um item de trabalho.

Usando os fluxos de trabalho de amostra de plug-in dovRealize Automation

Você pode usar os fluxos de trabalho da amostra como exemplos ou como pontos de partida para criar seuspróprios fluxos de trabalho personalizados.

Esses fluxos de trabalho estão localizados na exibição Fluxos de Trabalho do cliente dovRealize Orchestrator, no subdiretório Amostra da biblioteca de plug-ins.


26 VMware, Inc.


Criar uma permissão Fornece um script de amostra que interage com o cliente de autorização e com o serviçode permissão para criar uma permissão no vRealize Automation.

Criar um tenant Cria um tenant com o mesmo host do vRealize Automation e configuração do ActiveDirectory que o tenant padrão. Para executar esse fluxo de trabalho, selecione o host dovRealize Automation que foi adicionado com as suas credenciais de administrador dosistema. É possível alterar as configurações do Active Directory antes de executar o fluxode trabalho.

Listar itens de catálogo Retorna uma lista de itens de catálogo para o tenant selecionado.

Imprimir solicitação deprovisionamento de item decatálogo como JSON

Recupera o formulário de solicitação padrão para um item de catálogo e o adiciona aolog do console no formato JSON. Você pode usar os dados para personalizar umasolicitação de provisionamento. É possível usar as informações para modificar o fluxo detrabalho Solicitar um item de catálogo com uma solicitação de provisionamento.

Acessar a API de plug-in do vRealize AutomationO Orchestrator fornece o API Explorer, para permitir que você pesquise a API de plug-in dovRealize Automation e consulte a documentação dos objetos JavaScript que podem ser usados em elementoscom script.

Para acessar a documentação atualizada da API do vRealize Automation, consulte https://www.vmware.com/support/pubs/vcac-pubs.html.

Procedimentos

1 Faça login no cliente do Orchestrator como um administrador.

2 Selecione Ferramentas > API Explorer.

3 Clique duas vezes nos módulos vCAC e VCACCAFE no painel à esquerda para expandir a listahierárquica de objetos da API de plug-in do vRealize Automation.

Próximo passo

Você pode copiar o código de elementos de API e colá-lo em caixas de script. Para obter mais informaçõessobre scripts de API, consulte Desenvolvendo com o VMware vRealize Orchestrator.

Para obter informações adicionais sobre práticas recomendadas de desenvolvimento, consulte Documentação do vRealize Orchestrator.


VMware, Inc. 27

https://www.vmware.com/support/pubs/vcac-pubs.html

https://www.vmware.com/support/pubs/orchestrator_pubs.html


28 VMware, Inc.

Exemplo de scripts de plug-in dovRealize Automation 4

Você pode recortar, colar e editar os exemplos de JavaScript fornecidos para desenvolver seus própriosscripts personalizados para a automatização de tarefas do vRealize Automation.

Este capítulo inclui os seguintes tópicos:

n “Scripts de exemplos de tarefas de administração da infraestrutura de CRUD”, na página 29

n “Localizando scripts de exemplos de entidades do vRealize Automation”, na página 33

n “Obter um recurso fornecido por um script de exemplo do vRealize Automation”, na página 34

n “Scripts de exemplos de tarefas comuns”, na página 35

Scripts de exemplos de tarefas de administração da infraestrutura deCRUD

Você pode recortar, colar e editar os exemplos de JavaScript para escrever scripts para tarefas de CRUD dovRealize Automation.

Para obter mais informações sobre scripts no vRealize Orchestrator, consulte Desenvolvendo com o VMwarevRealize Orchestrator.

Exemplo: Criar uma entidade de modelo do vRealize AutomationEste script de exemplo realiza as seguintes ações:

1 Define o nome do modelo e o nome do conjunto de entidades.

2 Define as propriedades do prefixo do host.

3 Salva a entidade de prefixo do host.

4 Define as propriedades do grupo de provisionamento.

5 Define o grupo de provisionamento como um link.

6 Salva a entidade de grupo de provisionamento, vinculando-a ao prefixo de nome de host.

Tabela 4‑1. Variáveis de entrada

Variável Tipo

host vCAC:VcacHost

var modelName = 'ManagementModelEntities.svc';

var entitySetName = 'HostNamePrefixes';

var links = null;

var headers = null;

VMware, Inc. 29

//Create properties for prefix entity

var prefixInputProperties = {

MachinePrefix:'test-prefix',

NextMachineNo:1,

MachineNumberLength:3

};

//Save the prefix

var prefixEntity = vCACEntityManager

.createModelEntity(host.id, modelName, entitySetName, prefixInputProperties, links, headers);

entitySetName = 'ProvisioningGroups';

//Create properties for the provisioning group entity

inputProperties = {

GroupName:'TestGroupName',

GroupDescription:'This group was generated with a vCO workflow',

AdministratorEmail:'[email protected]',

AdContainer:'AD',

IsTestGroup:false,

Flags:2,

GroupType:1};

//Add a reference to the newly created prefix entity

links = {

HostNamePrefix:prefixEntity

};

//Save the provisioning group

var entity = vCACEntityManager.createModelEntity(host.id, modelName, entitySetName,

inputProperties, links, headers);

Exemplo: Atualizar uma entidade de modelo do vRealize AutomationEste script de exemplo realiza as seguintes ações:

1 Obtém o ID de host da entidade provisionada.

2 Obtém o nome do modelo da entidade provisionada.

3 Obtém o nome do conjunto de entidades da entidade provisionada.

4 Obtém o ID de entidade da entidade provisionada.

5 Define um conjunto de propriedades que serão atualizadas.

6 Inicia a ação responsável pela atualização da entidade.


Variável Tipo

entity vCAC:Entity

updatedDescription Cadeia de caracteres

var hostId = entity.hostId;

var modelName = entity.modelName;

var entitySetName = entity.entitySetName;

var entityIdString = entity.keyString;

var links = null;

var headers = null;

var updateProperties = new Properties();

updateProperties.put("UserNameDescription", updatedDescription);


30 VMware, Inc.

//Update the user description

System.getModule("com.vmware.library.vcac")

.updateVCACEntity(hostId, modelName, entitySetName, entityIdString, updateProperties, links,

headers);

Exemplo: Ler uma entidade de modelo do vRealize AutomationEste script de exemplo realiza as seguintes ações:


2 Define o ID do blueprint com um objeto de propriedade.

3 Lê a entidade.


Variável Tipo

host vCAC:VcacHost

blueprintID Cadeia de caracteres


var entitySetName = 'VirtualMachineTemplates';

var links = null;

var headers = null;

//Create properties for the prefix entity

var blueprintId = {

VirtualMachineTemplateID:blueprintId,

};

//Read the blueprint

var entity = vCACEntityManager

.readModelEntity(host.id, modelName, entitySetName, blueprintId, headers);

Exemplo: Excluir uma entidade de modelo do vRealize AutomationEste script de exemplo realiza as seguintes ações:

1 Obtém o ID de host da entidade provisionada.

2 Obtém o nome do modelo da entidade provisionada.

3 Obtém o nome do conjunto de entidades da entidade provisionada.

4 Obtém o ID de entidade da entidade provisionada.

5 Inicia a ação responsável pela exclusão da entidade.


Variável Tipo

entity vCAC:Entity

var hostId = entity.hostId;

var modelName = entity.modelName;

var entitySetName = entity.entitySetName;

var entityKeyString = entity.keyString;

var headers = null;

//Delete the entity

System.getModule("com.vmware.library.vcac")

.deleteVCACEntity(hostId, modelName, entitySetName, entityKeyString, headers);

Capítulo 4 Exemplo de scripts de plug-in do vRealize Automation

VMware, Inc. 31

Exemplo: Ler uma entidade do vRealize Automation por filtro personalizadoEste script de exemplo realiza as seguintes ações:


2 Define as propriedades com base nas quais as entidades são filtradas.

3 Lê uma lista de entidades.


Variável Tipo

host vCAC:VcacHost

templateName Cadeia de caracteres


var entitySetName = 'VirtualMachineTemplates';

var headers = null;

//Create properties for prefix entity

var properties = {

VirtualMachineTemplateName:templateName,

};

//Read a list of entities

var entities = vCACEntityManager

.readModelEntitiesByCustomFilter(host.id, modelName, entitySetName, properties, headers);

Exemplo: Ler uma entidade do vRealize Automation por consulta de sistemaEste script de exemplo realiza as seguintes ações:


2 Define as consultas de sistema com base nas quais as entidades são filtradas e seleciona os dezprincipais resultados de todas as máquinas virtuais, filtrados por estado da máquina e sinalizador decomponente.

3 Lê uma lista de entidades.


Variável Tipo

host vCAC:VcacHost


var entitySetName = 'VirtualMachines';

var filter = "VirtualMachineState eq 'Off' and IsComponent eq true";

var orderBy = 'VirtualMachineName asc';

var top = 10; {

var skip = 0;,

var headers = null;

var select = null;

var entities = vCACEntityManager

readModelEntitiesBySystemQuery(host.id, modelName, entitySetName, filter, orderBy, select,

top, skip, headers);


32 VMware, Inc.

Localizando scripts de exemplos de entidades dovRealize Automation

Você pode recortar, colar e editar os exemplos de JavaScript para escrever scripts para localizar entidades dovRealize Automation usando o objeto do utilitário de scripts vCACCAFEEntitiesFinder.


Exemplo: Localizar recursos de catálogo filtrados por nomeTabela 4‑7. Variáveis de entrada

Variável Tipo

host vCACCAFE:VcacHost

É possível usar um dos seguintes exemplos:

n Este script de exemplo obtém todos os recursos de catálogo para o host de destino que correspondem àconsulta nome_do_recurso por nome e descrição.

var items = vCACCAFEEntitiesFinder.findCatalogResources(host, "nome_do_recurso");

n Este script de exemplo realiza as seguintes ações:

a Obtém o serviço de Recurso de Consumidor e invoca o método get, transmitindo como umparâmetro Pageable uma instância do objeto vCACCAFEPageOdataRequest.

b Cria o objeto vCACCAFEPageOdataRequest fornecendo uma consulta OData como um único filtro doatributo name que corresponde à cadeia de caracteres nome_do_recurso.

var service = host.createCatalogClient().getCatalogConsumerResourceService();

var filter = new Array();

filter[0] = vCACCAFEFilterParam.equal("name", vCACCAFEFilterParam.string("nome_do_recurso"));

var query = vCACCAFEOdataQuery.query().addFilter(filter);

var items = service.getResourcesList(new vCACCAFEPageOdataRequest(query));

Exemplo: Localizar recursos de catálogo filtrados por proprietárioEste script de exemplo realiza as seguintes ações:

1 Obtém o serviço de Recurso de Consumidor e invoca o método get, transmitindo como um parâmetroPageable uma instância do objeto vCACCAFEPageOdataRequest.

2 Cria o objeto vCACCAFEPageOdataRequest fornecendo uma consulta OData como um único filtro doatributo owner/ref que corresponde à cadeia de caracteres usuário@domínio.com.

O atributo owners/ref é uma composição baseada na estrutura interna e nos campos dos recursos decatálogo. A entidade vCACCAFECatalogResource possui o atributo owners, que é uma coleção deentidades vCACCAFECatalogPrincipal. A entidade vCACCAFECatalogPrincipal possui a propriedade ref,que é uma representação de cadeia de caracteres do ID de entidade de segurança do usuário.


filter[0] = vCACCAFEFilterParam.substringOf("owners/ref",

vCACCAFEFilterParam.string("usuário@domínio.com"));




VMware, Inc. 33

Exemplo: Localizar recursos de catálogo filtrados por nome e proprietárioEsse script de exemplo combina as consultas OData dos dois exemplos anteriores em uma única condição,usando o operador lógico vCACCAFEFilterParam.and(array of conditions).

var conditions = new Array();

conditions[0] = vCACCAFEFilterParam.equal("name",

vCACCAFEFilterParam.string("name_of_the_resource_here"));

conditions[1] = vCACCAFEFilterParam.substringOf("owners/ref",

vCACCAFEFilterParam.string("[email protected]"));


filter[0] = vCACCAFEFilterParam.and(conditions);



Você pode definir outras condições usando diferentes operadores lógicos, comovCACCAFEFilterParam.group(array of parameters), vCACCAFEFilterParam.not(parameter),vCACCAFEFilterParam.startsWith(id, string), vCACCAFEFilterParam.endsWith(id, string),vCACCAFEFilterParam.greaterThan(id, number), vCACCAFEFilterParam.lessThan(id, number) e assim pordiante.

Obter um recurso fornecido por um script de exemplo dovRealize Automation

Você pode recortar, colar e editar o exemplo JavaScript para escrever scripts de recuperação das entidadesreais de recursos provisionados do vRealize Automation.

O tipo CatalogResource representa os recursos provisionados no vRealize Automation. Esse tipo tem umatributo do tipo ProviderBinding, que representa a relação entre o recurso de catálogo e seu provedor comos seguintes atributos:

n bindingId - representa o identificador da entidade, que é exclusivo para o provedor

n providerRef - identifica o provedor do catálogo, que corresponde diretamente a um serviço registradono registro do componentes do vRealize Automation


Exemplo: Obter uma máquina virtual provisionada como um recurso decatálogo do vRealize Automation

Esse exemplo usa um host do vRealize Automation e seu host do IaaS como parâmetros de entrada e, paraum ID de recurso provisionado, retorna a máquina virtual IaaS correspondente. O código de script usaapenas recursos de catálogo do tipo Virtual Machine que são provisionados pelo provedor iaas-service.


34 VMware, Inc.


Variável Tipo

vcacHost vCACCAFE:VCACHost

iaasHost vCAC:VCACHost

// Id of the catalog resource (or vCACCAFECatalogResource_instance.getId())

var resourceId = "c222629c-6f90-4458-8c92-8ece0ba06173";

var resource = vCACCAFEEntitiesFinder.getCatalogResource(vcacHost, resourceId);

var resourceType = resource.getResourceTypeRef().getLabel();

System.log("resource type: " + resourceType);

var providerBinding = resource.getProviderBinding();

var bindingId = providerBinding.getBindingId();

System.log("provider binding id: " + bindingId);

var provider = providerBinding.getProviderRef();

System.log("provider id: " + provider.getId());

System.log("provider name: " + provider.getLabel());

if ((resourceType == "Virtual Machine") && (provider.getLabel() == "iaas-service")) {

System.log("It is an IaaS VM!");

// IaaS virtual machine

var vm = Server.findForType("vCAC:VirtualMachine", bindingId);

System.log("IaaS VM id: " + vm.virtualMachineID);

System.log("IaaS VM name: " + vm.displayName);

// IaaS Entity

var entity =

System.getModule("com.vmware.library.vcac").getVirtualMachineEntityFromId(iaasHost, bindingId);

System.log("IaaS entity id: " + entity.keyString);

}

Scripts de exemplos de tarefas comunsVocê pode recortar, colar e editar os exemplos de JavaScript ou usá-los como amostras para ajudar a sabermais sobre como desenvolver seus próprios scripts para tarefas comuns do vRealize Automation.


Exemplo: Criar um blueprint de serviço avançado do vRealize AutomationEste script de exemplo realiza as seguintes ações:

1 Define o fluxo de trabalho do vRealize Orchestrator usado para construir o blueprint de serviço.

2 Gera o conteúdo para o blueprint de serviço com base no fluxo de trabalho.

3 Cria a entidade de blueprint de serviço.

4 Publica o blueprint de serviço.


VMware, Inc. 35


Variável Tipo

host vCACCAFE:VCACHost

//ID of the workflow used to create the service blueprint

var workflowId = "44e42047-2fa0-4e4a-ba0c-12086540b28b";

var name = "MyBlueprint"

var description = "Blueprint description";

var workflowClient = host.createAdvancedDesignerClient().getAdvancedDesignerWorkflowService();

//Generate a service blueprint based on the workflow ID

var blueprint = workflowClient.generateServiceBlueprintByWorkflowId(workflowId);

blueprint.setTenant(host.tenant);

blueprint.setName(name);

blueprint.setDescription(description);

//Create the service blueprint

var blueprintService =

host.createAdvancedDesignerClient().getAdvancedDesignerServiceBlueprintService();

var uri = blueprintService.createServiceBlueprint(host.tenant , blueprint);

//Publish the service blueprint

var createdBlueprint = blueprintService.getServiceBlueprintByUri(uri);

blueprintService.updateServiceBlueprintStatus(host.tenant, createdBlueprint.getId(),

vCACCAFEDesignerPublishStatus.PUBLISHED);

Exemplo: Cria uma política de aprovação do vRealize AutomationEste script de exemplo realiza as seguintes ações:

1 Obtém o tipo de política de aprovação.

2 Define o usuário e o grupo cuja aprovação é necessária.

3 Define os níveis de aprovação.

4 Define a fase de aprovação pré-provisionamento.

5 Define a fase de aprovação pós-provisionamento.

6 Define as especificações de políticas de aprovação, como nome, descrição e tipo.

7 Cria a política de aprovação.

8 Publica a política de aprovação. Uma vez que publicada, uma política de aprovação torna-se somenteleitura.


Variável Tipo

host vCACCAFE:VCACHost

// Get the type of approval policy by ID

var typeService = host.createApprovalClient().getApprovalApprovalPolicyTypeService();

var type = typeService.getApprovalPolicyType("com.vmware.cafe.catalog.request");

// Set the user and group required to complete the approval


36 VMware, Inc.

var user = new vCACCAFEApprovalPrincipal();

user.setValue("[email protected]");

user.setType(vCACCAFEApprovalPrincipalType.USER);

var group = new vCACCAFEApprovalPrincipal();

group.setValue("[email protected]");

group.setType(vCACCAFEApprovalPrincipalType.GROUP);

// Set the level of the approval

var level = new vCACCAFEApprovalLevel();

level.setName("IT Approval Level");

level.setDescription("IT Approval Level description");

level.setApprovalMode(vCACCAFEApprovalMode.ALL);

System.getModule("com.vmware.library.vcaccafe.util").addElementToList(level, "getApprovers",

user);

System.getModule("com.vmware.library.vcaccafe.util").addElementToList(level, "getApprovers",

group);

level.setLevelNumber(1);

// Set pre-provisioning phase type and the phase of the approval

var phase1Type = new vCACCAFEApprovalPhaseType();

phase1Type.setId("com.vmware.cafe.catalog.request.pre");

phase1Type.setName("Pre-Provisioning type");

phase1Type.setDescription("Pre-Provisioning type description");

phase1Type.setPhaseOrder(1);

var phase1 = new vCACCAFEPhase();

phase1.setName("Pre-Provisioning");

phase1.setDescription("Pre provisioning phase");

phase1.setPhasetype(phase1Type);

System.getModule("com.vmware.library.vcaccafe.util").addElementToList(phase1, "getLevels",

level);

// Set post-provisioning phase type and the phase of the approval

var phase2Type = new vCACCAFEApprovalPhaseType();

phase2Type.setId("com.vmware.cafe.catalog.request.post");

phase2Type.setName("Post-Provisioning type");

phase2Type.setDescription("Post-Provisioning type description");

phase2Type.setPhaseOrder(1);

var phase2 = new vCACCAFEPhase();

phase2.setName("Post-Provisioning");

phase2.setDescription("Post provisioning phase");

phase2.setPhasetype(phase2Type);

System.getModule("com.vmware.library.vcaccafe.util").addElementToList(phase2, "getLevels",

level);

// Create the approval policy specifications

var spec = new vCACCAFEApprovalPolicy();

spec.setName("New Policy");

spec.setDescription("New Policy description");

spec.setPolicyType(type);

System.getModule("com.vmware.library.vcaccafe.util").addElementToList(spec, "getPhases", phase1);

System.getModule("com.vmware.library.vcaccafe.util").addElementToList(spec, "getPhases", phase2);


VMware, Inc. 37

// Create the approval policy

var approvalPolicyService = host.createApprovalClient().getApprovalApprovalPolicyService();

var approvalPolicy = approvalPolicyService.createPolicy(spec);

// Publish the approval policy

approvalPolicy.setState(vCACCAFEApprovalPolicyState.PUBLISHED);

approvalPolicy = approvalPolicyService.update(approvalPolicy);

System.log("New approval policy id: " + approvalPolicy.getId());


38 VMware, Inc.

Índice

AAcesso à API 27adicionando uma entidade de modelo do

vRealize Automation 24audiência 5

Bbiblioteca de fluxos de trabalho 13, 29

Eelementos de tarefas programáveis por

script 29, 35entidade de modelo do vRealize Automation

adicionando 24lendo 25

exemplo 33, 34

Ffluxos de trabalho

configurando 9CRUD 16, 22, 26entidade de modelo 16, 22, 26fluxos de trabalho de extensibilidade 22fluxos de trabalho de solicitações 25fluxos de trabalho padrão 16, 22, 26IaaS 22

Hhost

configurando 9gerenciando 9

host IaaS, configurando 11host vRealize Automation, configurando 10

IInventário 15

Llendo uma entidade de modelo do vRealize

Automation 25localizando recursos de catálogo 33

Oobtendo uma máquina virtual provisionada 34Operações CRUD, vRealize Automation 13, 14

Pplug-in do vRealize Automation

configurando 9introdução 7

Sscripts 29, 35

Uusando o objeto vCACCAFEEntitiesFinder 33

VvRealize Automation, Operações CRUD 13, 14vRealize Orchestrator 7

VMware, Inc. 39


40 VMware, Inc.

n Automation 7 - docs.vmware.com€¦ · vRealize Automation 7 Função do vRealize Orchestrator com o plug-in do vRealize Automation 7 2 Configurando o plug-in do vRealize Automation

Documents

n Automation 7 - docs.vmware.com€¦ · vRealize Automation 7 Função do vRealize Orchestrator com o plug-in do vRealize Automation 7 2 Configurando o plug-in do vRealize Automation