Concetti avanzati

I moduli OCI per PowerShell supportano l'uso delle variabili di ambiente in una sessione PowerShell per specificare i valori di alcuni parametri comuni facoltativi. Queste variabili di ambiente possono essere configurate direttamente nella sessione PowerShell o utilizzando il cmdlet Set-OCIClientSession. I valori assegnati a queste variabili di ambiente vengono utilizzati per effettuare chiamate API solo nella sessione PowerShell in cui sono impostate.

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

Nella valutazione dei parametri, i moduli OCI per PowerShell seguono il presente ordine di precedenza:

1. Il valore specificato nel parametro cmdlet.
2. Il valore specificato nelle preferenze di sessione.
3. Valore specificato nel profilo selezionato dall'utente del file di configurazione OCI situato in ~/.oci/config.

È possibile utilizzare l'archivio storico per:

L'area di memorizzazione cronologia è incapsulata come oggetto Oci.PSModules.Common.Cmdlets.CmdletHistory.OCICmdletHistoryStore in una variabile PowerShell denominata $OCICmdletHistory.

Per ulteriori informazioni, vedere l'esempio Area di memorizzazione cronologia su GitHub.

I Cmdlet OCI che richiamano le operazioni API elenco hanno la possibilità di impaginare i risultati, consentendo di recuperare i risultati disponibili in batch (seguendo automaticamente i token di impaginazione) fino a quando non saranno disponibili altri record.

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 maggior parte delle risorse Oracle Cloud Infrastructure, come le istanze di computazione, hanno cicli di vita. In molti casi, è necessario che il comando aspetti che una risorsa o una richiesta di lavoro raggiunga uno stato specifico oppure che venga superato il timeout prima di eseguire ulteriori azioni. È possibile eseguire il polling di una risorsa per determinarne lo stato.

I moduli OCI per PowerShell offrono parametri del cameriere che consentono al cmdlet di attendere fino a quando una risorsa raggiunge lo stato desiderato. Un cmdlet con parametri del cameriere può essere richiamato in modo bloccante per attendere il raggiungimento di uno degli stati desiderati o il superamento di un timeout. I camerieri estraggono la logica di polling che altrimenti dovresti aggiungere prima di intraprendere ulteriori azioni su una risorsa o una richiesta di lavoro.

Ad esempio, quando si chiama LaunchInstance nel servizio di calcolo, l'intestazione della risposta contiene un valore work-request-id. I moduli OCI per PowerShell utilizzano questo ID quando si specifica il parametro -WaitForStatus, il che fa sì che lo script aspetti che la richiesta di lavoro riesca prima di continuare.

#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

In questo esempio su GitHub viene illustrato come utilizzare i flussi.

Per facilitare la risoluzione dei problemi, i moduli OCI per PowerShell supportano la registrazione dei messaggi a livello di debug e verbose nella console oltre ai messaggi di errore. Questa funzione è stata integrata con i parametri standard PowerShell Debug e Verbose.

Passare i parametri -Debug o -Verbose nel richiamo del cmdlet per visualizzare i messaggi di log nella console.

Ad esempio:

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

Principali istanze è una funzione del servizio IAM che consente alle istanze di essere attori (o principal) autorizzati in grado di eseguire azioni sulle risorse del servizio. Ogni istanza di computazione ha la propria identità e viene autenticata utilizzando i certificati aggiunti. Questi certificati vengono creati automaticamente, assegnati alle istanze e ruotati, evitando di dover distribuire le credenziali agli host e ruotarle.

Per abilitare l'autenticazione del principal dell'istanza dai Cmdlet OCI, chiamare autorizza l'istanza e impostare il parametro AuthType. Ad esempio:

PS /> Get-OCIIdentityRegionsList -AuthType InstancePrincipal

Abilitazione dei modelli di endpoint specifici del realm a livello di applicazione:

Abilitazione dei modelli di endpoint specifici del realm a livello di client:

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

Per un esempio completo, vedere l'esempio CreateBucketUsingRealmSpecificEndpoint_ObjectStorage su GitHub.