Conceptos avanzados

Los módulos OCI para PowerShell soportan el uso de variables de entorno en una sesión de PowerShell para especificar valores de algunos parámetros comunes opcionales. Estas variables de entorno se pueden configurar directamente en la sesión de PowerShell o mediante el cmdlet Set-OCIClientSession. Los valores asignados a estas variables de entorno se utilizan para realizar llamadas de API solo en la sesión de PowerShell en la que se han definido.

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

Al evaluar los parámetros, los módulos OCI para PowerShell siguen este orden de prioridad:

1. Valor especificado en el parámetro cmdlet.
2. Valor especificado en las preferencias de sesión.
3. Valor especificado en el perfil seleccionado por el usuario del archivo de configuración de OCI ubicado en ~/.oci/config.

Puede utilizar el almacén de historial para:

El almacén de historial se encapsula como un objeto Oci.PSModules.Common.Cmdlets.CmdletHistory.OCICmdletHistoryStore en una variable de PowerShell denominada $OCICmdletHistory.

Para obtener más información, consulte el ejemplo de almacén de historial en GitHub.

Los cmdlets de OCI que llaman a operaciones de API de listas tienen la capacidad de paginar resultados, lo que les permite recuperar los resultados disponibles en lotes (automáticamente después de los tokens de paginación) hasta que no haya más registros disponibles.

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

La mayoría de las instancias de Oracle Cloud Infrastructure, como las instancias informáticas, tienen ciclos de vida. En muchos casos, desea que el comando espere hasta que un recurso o una solicitud de trabajo lleguen a un estado específico, o se exceda el timeout, antes de realizar otras acciones. Puede sondear un recurso para determinar su estado.

Los módulos OCI para PowerShell ofrecen parámetros de espera que permiten que el cmdlet espere hasta que un recurso alcance el estado deseado. Se puede llamar a un cmdlet con parámetros de espera de forma bloqueada para esperar hasta que se alcance uno de los estados deseados o se supere un timeout. Las esperas sintetizan la lógica de sondeo que de lo contrario tendría que agregar antes de realizar más acciones en un recurso o una solicitud de trabajo.

Por ejemplo, al llamar a LaunchInstance en el servicio de cálculo, la cabecera de respuesta contiene una work-request-id. Los módulos OCI para PowerShell utilizan este ID al especificar el parámetro -WaitForStatus, lo que hace que el script espere hasta que la solicitud de trabajo se realice correctamente 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

Este ejemplo de GitHub muestra cómo trabajar con flujos.

Para facilitar la resolución de problemas, los módulos OCI para PowerShell soportan el registro de mensajes de nivel debug y verbose en la consola, además de mensajes de error. Esta función se ha integrado con los parámetros estándar Debug y Verbose de PowerShell.

Transfiera los parámetros -Debug o -Verbose en la llamada de cmdlet para ver los mensajes log en la consola.

Por ejemplo:

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

Principales de instancia es una función del servicio de IAM que permite que las instancias sean actores autorizados (o principales) que puedan realizar acciones en los recursos de servicio. Cada instancia informática tiene su propia identidad y se autentica con los certificados que se le agregan. Estos certificados se crean, se asignan a instancias y se rotan automáticamente, de modo que usted no necesita distribuir credenciales a sus hosts y rotarlos.

Para activar la autenticación de principal de instancia desde los Cmdlets de OCI, autorice a la instancia para realizar llamadas y defina el parámetro AuthType. Por ejemplo:

PS /> Get-OCIIdentityRegionsList -AuthType InstancePrincipal

Activación de plantillas de punto final específicas de dominio en el nivel de aplicación:

Activación de plantillas de punto final específicas del dominio en el nivel de cliente:

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

Para ver un ejemplo completo, consulte el ejemplo CreateBucketUsingRealmSpecificEndpoint_ObjectStorage en GitHub.