Conceitos Avançados

Os Módulos do OCI para PowerShell suportam o uso de variáveis de ambiente em uma sessão do PowerShell para especificar os valores de alguns parâmetros comuns opcionais. Essas variáveis de ambiente podem ser configuradas diretamente na sessão do PowerShell ou usando o cmdlet Set-OCIClientSession. Os valores designados a essas variáveis de ambiente são usados para fazer chamadas de API somente na sessão do PowerShell na qual elas estão definidas.

PS /> $Env:OCI_PS_REGION="us-phoenix-1"

PS /> Set-OCIClientSession -RegionId "us-ashburn-1" -Profile "Test" -Config "~/.oci/testconfig"
 
RegionId     Profile Config
--------     ------- ------
us-ashburn-1 Test    ~/.oci/testconfig

PS /> Get-OCIClientSession                                                                    
 
RegionId     Profile Config
--------     ------- ------
us-ashburn-1 Test

Ao avaliar parâmetros, os Módulos do OCI para PowerShell seguem esta ordem de precedência:

1. O valor especificado no parâmetro cmdlet.
2. O valor especificado nas preferências da sessão.
3. O valor especificado no perfil selecionado pelo usuário do arquivo de configuração do OCI localizado em ~/.oci/config.

Você pode usar o armazenamento de histórico para:

O armazenamento de histórico é encapsulado como objeto Oci.PSModules.Common.Cmdlets.CmdletHistory.OCICmdletHistoryStore em uma variável do PowerShell denominada $OCICmdletHistory.

Para obter mais informações. consulte o exemplo de Armazenamento de Histórico no GitHub.

Os Cmdlets do OCI que chamam as operações de API de lista têm a capacidade de paginar resultados, permitindo que você recupere os resultados disponíveis em batches (automaticamente após tokens de paginação) até que não haja mais registros disponíveis.

PS /> Get-OCIComputeImagesList -CompartmentId $Env:CompartmentId | Measure-Object
 
Count             : 100

PS /> Get-OCIComputeImagesList -CompartmentId $Env:CompartmentId -Limit 5 | Measure-Object                                       
 
Count             : 5

PS /> Get-OCIComputeImagesList -CompartmentId $Env:CompartmentId -Page $OCICmdletHistory.LastResponse.OpcNextPage | Measure-Object
 
Count             : 100

PS /> Get-OCIComputeImagesList -CompartmentId $Env:CompartmentId -All | Measure-Object                                            
 
Count             : 293

A maioria dos recursos do Oracle Cloud Infrastructure, como instâncias de computação, tem calogramas de vida. Em muitos casos, você deseja que seu comando aguarde até que um recurso ou uma solicitação de serviço atinja um estado específico, ou que um timeout seja excedido, antes de executar outras ações. Você pode sondar um recurso para determinar seu estado.

Os Módulos do OCI para PowerShell oferecem parâmetros waiter que permitem que o cmdlet aguarde até que um recurso atinja um estado desejado. Um cmdlet com parâmetros waiter pode ser chamado de forma bloqueadora para aguardar até que um dos estados desejados seja atingido ou um timeout seja excedido. Os waiters resumem a lógica de sondagem que você teria de adicionar antes de tomar mais ações sobre um recurso ou uma solicitação de serviço.

Por exemplo, quando você chama LaunchInstance no serviço Compute, o cabeçalho de resposta contém work-request-id. Os Módulos do OCI para PowerShell usam esse ID quando você especifica o parâmetro -WaitForStatus, o que faz com que seu script aguarde até que a solicitação de serviço seja bem-sucedida antes de continuar.

#Create a new compute instance and wait for the instance work request to succeed or fail, 
#polling every 60 seconds and attempting 20 times max
$ComputeInstance = New-OCIComputeInstance -LaunchInstanceDetails $LaunchDetails -WaitForStatus Succeeded,Failed -MaxWaitAttempts 20 -WaitIntervalSeconds 60

Esta amostra no GitHub indica como trabalhar com streams.

Para facilitar a solução de problemas, os Módulos do OCI para PowerShell suportam o registro em log de mensagens nos níveis debug- e verbose- na console, além de mensagens de erro. Esse recurso foi integrado aos parâmetros padrão Debug e Verbose do PowerShell.

Informe os parâmetros -Debug ou -Verbose na chamada do cmdlet para ver mensagens de log na console.

Por exemplo:

PS /> Get-OCIComputeImagesList -CompartmentId $Env:CompartmentId -Limit 1 -Verbose
 
#More Verbose
PS /> Get-OCIComputeImagesList -CompartmentId $Env:CompartmentId -Limit 1 -Debug

Controladores de instâncias é um recurso do serviço IAM que permite que as instâncias sejam atores (ou controladores) autorizados que possam executar ações em recursos de serviço. Cada instância de computação tem sua própria identidade e autentica usando os certificados que são adicionados a ela. Esses certificados são criados automaticamente, designados a instâncias e rotacionados, evitando que você distribua as credenciais para seus hosts e as rotacione.

Para ativar a autenticação do controlador de instâncias nos Cmdlets do OCI, chame autorizar a instância e defina o parâmetro AuthType. Por exemplo:

PS /> Get-OCIIdentityRegionsList -AuthType InstancePrincipal

Ativando modelos de ponto final específicos do realm no nível do aplicativo:

Ativando modelos de ponto final específicos do realm no nível do cliente:

$NamespaceName = Get-OCIObjectStorageNamespace -CompartmentId $CompartmentId -UseRealmSpecificEndpoint -Debug

Para obter um exemplo completo, consulte o exemplo CreateBucketUsingRealmSpecificEndpoint_ObjectStorage no GitHub.