高度な概念

OCI Modules for PowerShellでは、PowerShellセッションの環境変数を使用して、一部のオプションの共通パラメータに値を指定できます。これらの環境変数は、PowerShellセッションで直接構成することも、Set-OCIClientSessionコマンドレットを使用して構成することもできます。これらの環境変数に割り当てられた値は、それらが設定されたPowerShellセッションでのみAPIコールを行うために使用されます。

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

パラメータを評価するとき、OCI Modules for PowerShellは次の優先順位に従います:

1. コマンドレット・パラメータで指定された値。
2. セッション・プリファレンスで指定された値。
3. ~/.oci/configにあるOCI構成ファイルのユーザー選択プロファイルで指定された値。

履歴ストアを使用して、次のことができます:

履歴ストアは、Oci.PSModules.Common.Cmdlets.CmdletHistory.OCICmdletHistoryStoreオブジェクトとして$OCICmdletHistoryという名前のPowerShell変数にカプセル化されます。

詳細は、GitHubの履歴ストアの例を参照してください。

リストAPI操作を呼び出すOCIコマンドレットでは、結果をページ区切りできます。これで、レコードがなくなるまで、(ページ区切りトークンに自動的に従って)得られた結果をバッチ単位で取得できます。

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

コンピュート・インスタンスなどのほとんどのOracle Cloud Infrastructureリソースにはライフサイクルが含まれます。多くのケースで、コマンドがさらにアクションを行う前に、リソースまたは作業リクエストが特定の状態になるまで、またはタイムアウトが超過するまで待機する必要があります。リソースをポーリングしてその状態を確認できます。

OCI Modules for PowerShellではウェイタ・パラメータが提供され、それを使用すると、リソースが目的の状態になるまでコマンドレットが待機できるようになります。ウェイタ・パラメータが指定されたコマンドレットは、目的の状態の1つに到達するかタイムアウトが超過するまで待機するように、ブロッキング方式で呼び出すことができます。リソースまたは作業リクエストに対してさらにアクションを実行する前に、ウェイタによりポーリング・ロジックが抽象化されます(これが行われない場合は、ユーザーが抽象化を追加する必要があります)。

たとえば、コンピュート・サービスでLaunchInstanceをコールすると、レスポンス・ヘッダーにwork-request-idが含まれます。OCI Modules for PowerShellがこのIDを使用するのは、ユーザーが-WaitForStatusパラメータを指定するときです。これによって、スクリプトは、作業リクエストが成功するまで待機してから続行するようになります。

#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

このGitHubのサンプルは、ストリームの使用方法を示しています。

トラブルシューティングを容易にするために、OCI Modules for PowerShellでは、エラー・メッセージに加えて、コンソールでのdebugレベルおよびverboseレベルのメッセージのロギングがサポートされています。この機能は、標準のPowerShell DebugおよびVerboseパラメータと統合されています。

コマンドレットの呼出しで-Debugまたは-Verboseパラメータを渡すと、コンソールにログ・メッセージが表示されます。

例:

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

インスタンス・プリンシパルはIAMサービス機能で、インスタンスが、サービス・リソースに対してアクションを実行できる認可済アクター(すなわちプリンシパル)になります。各コンピュート・インスタンスは、自身のアイデンティティを持ち、追加された証明書を使用して認証を行います。これらの証明書は自動的に作成され、インスタンスに割り当てられてローテーションされ、ホストに資格証明を配布してローテーションする必要がなくなります。

OCIコマンドレットからインスタンス・プリンシパル認証を有効にするには、インスタンスを認可してAuthTypeパラメータを設定します。例:

PS /> Get-OCIIdentityRegionsList -AuthType InstancePrincipal

アプリケーション・レベルでのレルム固有のエンドポイント・テンプレートの有効化:

クライアント・レベルでのレルム固有のエンドポイント・テンプレートの有効化:

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

完全な例は、GitHubのCreateBucketUsingRealmSpecificEndpoint_ObjectStorageの例を参照してください。