APIを使用してnull値を表現するには、0(ゼロ) を使用します。例えば、コンピュータのpolicyIDとして0を使用すると、それはnullとして解釈され、そのコンピュータには割り当てられたポリシーがないことを意味します。

これは、APIを直接使用する場合に適用されることに注意してください。クライアントライブラリはnull値の使用をサポートしています。

APIを使用する際は、Booleanプロパティの値にtrueまたはfalseのいずれかを使用する必要があります。それ以外の値を使用するとエラーが返されます。

値を指定しない場合 (例えば、null)、falseがデフォルト値になります。

操作を使用してリソースを変更する場合は、変更する必要があるプロパティのみを指定します。たとえば、ポリシーの名前を変更するには、ポリシーオブジェクトにnameプロパティを指定します。他のすべてのプロパティはnullまたは指定されていません。このパターンファイルはREST APIの典型的なパターンです。

Python、JavaScript、Javaなどのプログラミング言語を使用する場合、リソースを表すオブジェクトを取得したり、プロパティを変更したり、アップデート呼び出しでオブジェクトを返すことに慣れている可能性があります。ただし、Workload Securityクライアントライブラリを使用してオブジェクトを作成する場合は、変更する値のみを設定し、そのオブジェクトをアップデート呼び出しで使用します。この例では、ポリシー名のみが変更されます。

policy = api.Policy()
policy.name = policy_name
policy_api = api.PoliciesApi()
policy_api.modifyPolicy(policyID, policy, false, "v1")