Concepts avancés

Les modules OCI pour PowerShell prennent en charge l'utilisation de variables d'environnement dans une session PowerShell afin d'indiquer les valeurs de certains paramètres courants facultatifs. Ces variables d'environnement peuvent être configurées directement dans la session PowerShell ou à l'aide de la cmdlet Set-OCIClientSession. Les valeurs affectées à ces variables d'environnement sont utilisées pour effectuer des appels d'API uniquement dans la session PowerShell dans laquelle elles sont définies.

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

Lors de l'évaluation des paramètres, les modules OCI pour PowerShell respectent l'ordre de priorité suivant :

1. Valeur spécifiée dans le paramètre de cmdlet.
2. Valeur spécifiée dans les préférences de session.
3. Valeur spécifiée dans le profil sélectionné par l'utilisateur du fichier de configuration OCI situé à l'emplacement ~/.oci/config.

Vous pouvez utiliser la banque d'historique pour effectuer les opérations suivantes :

La banque d'historique est encapsulée en tant qu'objet Oci.PSModules.Common.Cmdlets.CmdletHistory.OCICmdletHistoryStore dans une variable PowerShell nommée $OCICmdletHistory.

Pour plus d'informations, reportez-vous à l'exemple de banque d'historique sur GitHub.

Les cmdlets OCI qui appellent des opérations d'API de liste peuvent paginer les résultats, ce qui vous permet d'extraire les résultats disponibles en lots (succession automatique des jetons de pagination) jusqu'à ce qu'aucun autre enregistrement ne soit disponible.

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 plupart des ressources Oracle Cloud Infrastructure, telles que les instances de calcul, ont des cycles de vie. Dans la plupart des cas, le code doit attendre qu'une ressource ou qu'une demande de travail atteigne un état spécifique, ou qu'un délai d'expiration soit dépassé, avant d'effectuer une autre action. Vous pouvez interroger une ressource pour déterminer son état.

Les modules OCI pour PowerShell offrent des paramètres de processus en attente qui permettent à votre cmdlet d'attendre qu'une ressource atteigne l'état souhaité. Vous pouvez appeler une cmdlet avec des paramètres de processus en attente de manière bloquante pour attendre que l'un des états souhaités soit atteint ou qu'un délai d'expiration soit dépassé. Les processus en attente extraient la logique d'interrogation, que vous devriez autrement ajouter avant d'effectuer d'autres actions sur une ressource ou une demande de travail.

Par exemple, lorsque vous appelez LaunchInstance dans le service Compute, l'en-tête de réponse contient l'ID work-request-id. Les modules OCI pour PowerShell utilisent cet ID lorsque vous indiquez le paramètre -WaitForStatus, ce qui oblige le script à attendre que la demande de travail soit terminée avant de continuer.

#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

Cet exemple sur GitHub montre comment utiliser les flux.

Pour faciliter la résolution des problèmes, les modules OCI pour PowerShell prennent en charge la journalisation des messages de niveau debug et verbose sur la console, en plus des messages d'erreur. Cette fonctionnalité a été intégrée aux paramètres standard Debug et Verbose de PowerShell.

Transmettez les paramètres -Debug ou -Verbose dans l'appel de la cmdlet pour afficher les messages de journal sur la console.

Par exemple :

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

Les principaux d'instance sont une fonctionnalité de service IAM qui permet aux instances d'être des acteurs autorisés (ou principaux) pouvant exécuter des actions sur les ressources de service. Chaque instance de calcul possède sa propre identité et est authentifiée à l'aide des certificats qui lui sont ajoutés. Ces certificats sont créés et affectés aux instances, et font également l'objet d'une rotation, le tout de façon automatique. Cela vous évite d'avoir à diffuser les informations d'identification aux hôtes et d'effectuer leur rotation.

Pour activer l'authentification par principal d'instance à partir des cmdlets OCI, autorisez l'instance à effectuer des appels et définissez le paramètre AuthType. Par exemple :

PS /> Get-OCIIdentityRegionsList -AuthType InstancePrincipal

Activer des modèles d'adresse propres à un domaine au niveau de l'application :

Activer des modèles d'adresse propres au domaine au niveau du client :

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

Pour un exemple complet, reportez-vous à l'exemple CreateBucketUsingRealmSpecificEndpoint_ObjectStorage sur GitHub.