Concepts avancés

Les modules OCI pour PowerShell prennent en charge l'utilisation de variables d'environnement dans une session PowerShell pour spécifier les valeurs de certains paramètres communs facultatifs. Ces variables d'environnement peuvent être configurées directement dans la session PowerShell ou à l'aide de l'applet de commande 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 suivent cet ordre de priorité :

1. Valeur spécifiée dans le paramètre d'applet de commande.
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é à ~/.oci/config.

Vous pouvez utiliser le magasin d'historiques pour :

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

Pour plus d'informations, voir l'exemple de magasin d'historiques dans GitHub.

Les applets de commande 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 (automatiquement après les 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, notamment les instances de calcul, comportent des cycles de vie. Dans la plupart des cas, vous voulez que votre code attende qu'une ressource ou une demande de travail ait atteint un état spécifique, ou qu'une temporisation soit dépassée, avant d'entreprendre une action supplémentaire. Vous pouvez scruter une ressource pour déterminer son état.

Les modules OCI pour PowerShell offrent des paramètres de processus en attente qui permettent à votre applet de commande d'attendre qu'une ressource atteigne un état souhaité. Un applet de commande avec des paramètres de processus en attente peut être appelé de manière bloquante pour attendre que l'un des états souhaités soit atteint ou qu'une temporisation soit dépassée. Les processus en attente convertissent la logique de scrutation (que vous auriez autrement à ajouter) avant d'entreprendre d'autres actions sur une ressource ou une demande de travail.

Par exemple, lorsque vous appelez LaunchInstance dans le service de calcul, l'en-tête de réponse contient un work-request-id. Les modules OCI pour PowerShell utilisent cet ID lorsque vous spécifiez le paramètre -WaitForStatus, qui fait que votre script attende que la demande de travail réussisse 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 le dépannage, les modules OCI pour PowerShell prennent en charge la journalisation des messages de niveau debug et verbose dans la console en plus des messages d'erreur. Cette fonction 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 l'applet de commande pour voir les messages des journaux dans la console.

Par exemple :

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

Principaux d'instance est une fonction de service IAM qui permet aux instances d'être des acteurs (ou principaux) autorisés pouvant effectuer des actions sur les ressources de service. Chaque instance de calcul possède sa propre identité et s'authentifie à l'aide des certificats qui y sont ajoutés. Comme ces certificats sont créés automatiquement, affectés à des instances et modifiés, vous n'avez pas besoin de transmettre des données d'identification à vos hôtes ni de les modifier.

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

PS /> Get-OCIIdentityRegionsList -AuthType InstancePrincipal

Activation des modèles de point d'extrémité propres à un domaine au niveau de l'application :

Activation des modèles de point d'extrémité propres au domaine au niveau du client :

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

Pour un exemple complet, voir l'exemple CreateBucketUsingRealmSpecificEndpoint_ObjectStorage sur GitHub.