Statement (iijgio-dag-client-all 1.2.4 API)

java.lang.Object
- com.iijgio.dag.auth.policy.Statement

```
public class Statement
extends Object
```
ステートメントは、一つの許可条件についての記載であり、ポリシーオブジェクトに含まれるものです。
一つのステートメントは、特定のIIJ GIOストレージ＆アナリシスサービスリソースに対するアクセスを許可・拒否するルールを表し、誰がリソースに対してアクセスできるかを定義します。また、ステートメントは、いつステートメントが効力を持つかについての条件を含むことが出来ます。
ステートメントは「Aが、BをCにする権限をDの場合に持つ」という形式をとります。それぞれ
- A: Principal - リソースへアクセスしたり、変更したりするIIJ GIOストレージ＆アナリシスサービスのアカウント
- B: Action - オブジェクトをバケットに保存するなど、どのようなアクションをIIJ GIOストレージ＆アナリシスサービスのリソースへ取るか
- C: Resource - オブジェクトなど、実際にアクションを取る対象となるIIJ GIOストレージ＆アナリシスサービスのリソース
- D: Conditionsセット - リソースへのアクセスの許可/拒否を行う条件を指定する場合のオプション。例えば、ある時間以降にアクセス可能とするなど
を意味します。
アクセスコントロールポリシーを定義するために、幾つかのリソースやコンディションが用意されています。適切なアクセスコントロールを行うために、これらを組み合わせてステートメントを定義してください

Nested Class Summary

Nested Classes
Modifier and Type	Class and Description
`static class`	`Statement.Effect` エフェクトは、ポリシーのステートメントを評価した際に返す値の列挙型です。ポリシーのステートメントはアクセスの許可または拒否を返します

Constructor Summary

Constructors
Constructor and Description
`Statement(Statement.Effect effect)` 新たにエフェクトを指定して、アクセスコントロールポリシーのステートメントを構築します。

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`List<Action>`	`getActions()` このステートメントで適用するアクションのリストを返します。アクションはステートメントで特定のサービスに対する操作を許可または制限したい場合に使用します。たとえば、オブジェクトの読み取りはすべてのユーザに許可したいが、書き込みやバケットの操作は行わせたくない場合などです
`List<Condition>`	`getConditions()` このステートメントに関連付けられたコンディションのリストを返します。コンディションはステートメントの評価の際に使用される条件を定義します。
`Statement.Effect`	`getEffect()` ステートメントが評価された際に返される、結果のエフェクトを返します。ポリシーステートメントは、許可又は拒否のいずれかをとります。
`String`	`getId()` このステートメントのIDを返します。ステートメントIDは複数のステートメントから一つを特定する手助けになるので、可読性の高い、意味を持った値を指定します。
`List<Principal>`	`getPrincipals()` このステートメントに関連付けられた、プリンシパルのリストを返します。プリンシパルは、このステートメントを適用するユーザアカウントを示します
`List<Resource>`	`getResources()` このステートメントに関連付けられたリソースを返します。リソースは、ステートメントがアクセスを許可・拒否する対象となります。
`void`	`setActions(Collection<Action> actions)` このステートメントで適用するアクションのリストをセットします。アクションはステートメントで特定のサービスに対する操作を許可または制限したい場合に使用します。たとえば、オブジェクトの読み取りはすべてのユーザに許可したいが、書き込みやバケットの操作は行わせたくない場合などです
`void`	`setConditions(List<Condition> conditions)` このステートメントに関連付けられたコンディションのリストをセットします。コンディションはステートメントの評価の際に使用される条件を定義します。
`void`	`setEffect(Statement.Effect effect)` ステートメントが評価された際に返される、結果のエフェクトをセットします。ポリシーステートメントは、許可又は拒否のいずれかをとります。
`void`	`setId(String id)` このステートメントのIDをセットします。ステートメントIDは複数のステートメントから一つを特定する手助けになるので、可読性の高い、意味を持った値を指定します。
`void`	`setPrincipals(Collection<Principal> principals)` このステートメントに関連付けられた、プリンシパルのリストをセットします。プリンシパルは、このステートメントを適用するユーザアカウントを示します
`void`	`setResources(Collection<Resource> resources)` このステートメントに関連付けられたリソースをセットします。リソースは、ステートメントがアクセスを許可・拒否する対象となります。
`Statement`	`withActions(Action... actions)` このステートメントで適用するアクションのリストをセットし、連続したメソッドの呼び出しのためにアップデートしたこのオブジェクトを返します。
`Statement`	`withConditions(Condition... conditions)` このステートメントに関連付けられたコンディションのリストをセットし、連続したメソッドの呼び出しのためにアップデートしたこのオブジェクトを返します。コンディションはステートメントの評価の際に使用される条件を定義します。
`Statement`	`withId(String id)` このステートメントのIDをセットし、連続したメソッドの呼び出しのためにアップデートしたこのオブジェクトを返します。ステートメントIDは複数のステートメントから一つを特定する手助けになるので、可読性の高い、意味を持った値を指定します。
`Statement`	`withPrincipals(Principal... principals)` このステートメントに関連付けられた、プリンシパルのリストをセットし連続したメソッドの呼び出しのためにアップデートしたこのオブジェクトを返します。プリンシパルは、このステートメントを適用するユーザアカウントを示します
`Statement`	`withResources(Resource... resources)` このステートメントに関連付けられたリソースをセットし、連続したメソッドの呼び出しのためにアップデートしたこのオブジェクトを返します。リソースは、ステートメントがアクセスを許可・拒否する対象となります。

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Constructor Detail
  - Statement
```
public Statement(Statement.Effect effect)
```
    新たにエフェクトを指定して、アクセスコントロールポリシーのステートメントを構築します。
    有効なステートメントとしてリクエストを送信する前に、プリンシパル・リソース・アクション(および、オプションとしてコンディション)をステートメントに設定してください。
    
    Parameters:
    
    effect - このステートメントが、すべての条件(プリンシパル・リソース・アクション・コンディション)に一致した場合にとるエフェクト（アクセスを許可するか、拒否するか)
- Method Detail
  - getId
```
public String getId()
```
    このステートメントのIDを返します。ステートメントIDは複数のステートメントから一つを特定する手助けになるので、可読性の高い、意味を持った値を指定します。
    ステートメントIDは、ポリシーの中でユニークである必要がありますが、グローバルにはユニークである必要はありません、。
    もし、ステートメントにIDを指定しなかった場合は、ステートメントをポリシーに追加した時点で自動的に割り当てられます。
    開発者は、同一のステートメントIDを複数のステートメントに使用しないよう注意してください。同じステートメントIDを異なったポリシーで再利用するのは問題ありません。
    
    Returns:
    
    ステートメントID
  - setId
```
public void setId(String id)
```
    このステートメントのIDをセットします。ステートメントIDは複数のステートメントから一つを特定する手助けになるので、可読性の高い、意味を持った値を指定します。
    ステートメントIDは、ポリシーの中でユニークである必要がありますが、グローバルにはユニークである必要はありません、。
    もし、ステートメントにIDを指定しなかった場合は、ステートメントをポリシーに追加した時点で自動的に割り当てられます。
    開発者は、同一のステートメントIDを複数のステートメントに使用しないよう注意してください。同じステートメントIDを異なったポリシーで再利用するのは問題ありません。
    
    Parameters:
    
    id - ステートメントID
  - withId
```
public Statement withId(String id)
```
    このステートメントのIDをセットし、連続したメソッドの呼び出しのためにアップデートしたこのオブジェクトを返します。ステートメントIDは複数のステートメントから一つを特定する手助けになるので、可読性の高い、意味を持った値を指定します。
    ステートメントIDは、ポリシーの中でユニークである必要がありますが、グローバルにはユニークである必要はありません、。
    もし、ステートメントにIDを指定しなかった場合は、ステートメントをポリシーに追加した時点で自動的に割り当てられます。
    開発者は、同一のステートメントIDを複数のステートメントに使用しないよう注意してください。同じステートメントIDを異なったポリシーで再利用するのは問題ありません。
    
    Parameters:
    
    id - ステートメントID
    
    Returns:
    
    アップデートされたステートメントオブジェクト
  - getEffect
```
public Statement.Effect getEffect()
```
    ステートメントが評価された際に返される、結果のエフェクトを返します。ポリシーステートメントは、許可又は拒否のいずれかをとります。
    
    Returns:
    
    このポリシーの結果となるエフェクト
  - setEffect
```
public void setEffect(Statement.Effect effect)
```
    ステートメントが評価された際に返される、結果のエフェクトをセットします。ポリシーステートメントは、許可又は拒否のいずれかをとります。
    
    Parameters:
    
    effect - このポリシーの結果となるエフェクト
  - getActions
```
public List<Action> getActions()
```
    このステートメントで適用するアクションのリストを返します。アクションはステートメントで特定のサービスに対する操作を許可または制限したい場合に使用します。たとえば、オブジェクトの読み取りはすべてのユーザに許可したいが、書き込みやバケットの操作は行わせたくない場合などです
    
    Returns:
    
    このステートメントを適用するアクションのリスト
  - setActions
```
public void setActions(Collection<Action> actions)
```
    このステートメントで適用するアクションのリストをセットします。アクションはステートメントで特定のサービスに対する操作を許可または制限したい場合に使用します。たとえば、オブジェクトの読み取りはすべてのユーザに許可したいが、書き込みやバケットの操作は行わせたくない場合などです
    
    Parameters:
    
    actions - このステートメントを適用するアクションのリスト
  - withActions
```
public Statement withActions(Action... actions)
```
    このステートメントで適用するアクションのリストをセットし、連続したメソッドの呼び出しのためにアップデートしたこのオブジェクトを返します。
    アクションはステートメントで特定のサービスに対する操作を許可または制限したい場合に使用します。たとえば、オブジェクトの読み取りはすべてのユーザに許可したいが、書き込みやバケットの操作は行わせたくない場合などです
    
    Parameters:
    
    actions - このステートメントを適用するアクションのリスト
    
    Returns:
    
    アップデートされたステートメントオブジェクト
  - getResources
```
public List<Resource> getResources()
```
    このステートメントに関連付けられたリソースを返します。リソースは、ステートメントがアクセスを許可・拒否する対象となります。
    
    Returns:
    
    このステートメントに関連付けられたリソース
  - setResources
```
public void setResources(Collection<Resource> resources)
```
    このステートメントに関連付けられたリソースをセットします。リソースは、ステートメントがアクセスを許可・拒否する対象となります。
    
    Parameters:
    
    resources - このステートメントに関連付けられたリソース
  - withResources
```
public Statement withResources(Resource... resources)
```
    このステートメントに関連付けられたリソースをセットし、連続したメソッドの呼び出しのためにアップデートしたこのオブジェクトを返します。リソースは、ステートメントがアクセスを許可・拒否する対象となります。
    
    Parameters:
    
    resources - このステートメントに関連付けられたリソース
    
    Returns:
    
    アップデートされたステートメントオブジェクト
  - getConditions
```
public List<Condition> getConditions()
```
    このステートメントに関連付けられたコンディションのリストを返します。コンディションはステートメントの評価の際に使用される条件を定義します。
    たとえば、ステートメントを特定のIPアドレスレンジからのアクセスや特定の時間以降のアクセスについて許可したい場合などに利用できます。
    複数のコンディションがステートメントに含まれている場合、すべてのコンディションが評価の際にtrueとなる場合にのみ、ステートメントが効果を持ちます
    
    Returns:
    
    このステートメントに関連付けられたコンディションのリスト
  - setConditions
```
public void setConditions(List<Condition> conditions)
```
    このステートメントに関連付けられたコンディションのリストをセットします。コンディションはステートメントの評価の際に使用される条件を定義します。
    たとえば、ステートメントを特定のIPアドレスレンジからのアクセスや特定の時間以降のアクセスについて許可したい場合などに利用できます。
    複数のコンディションがステートメントに含まれている場合、すべてのコンディションが評価の際にtrueとなる場合にのみ、ステートメントが効果を持ちます
    
    Parameters:
    
    conditions - このステートメントに関連付けられたコンディションのリスト
  - withConditions
```
public Statement withConditions(Condition... conditions)
```
    このステートメントに関連付けられたコンディションのリストをセットし、連続したメソッドの呼び出しのためにアップデートしたこのオブジェクトを返します。コンディションはステートメントの評価の際に使用される条件を定義します。
    たとえば、ステートメントを特定のIPアドレスレンジからのアクセスや特定の時間以降のアクセスについて許可したい場合などに利用できます。
    複数のコンディションがステートメントに含まれている場合、すべてのコンディションが評価の際にtrueとなる場合にのみ、ステートメントが効果を持ちます
    
    Parameters:
    
    conditions - このステートメントに関連付けられたコンディションのリスト
    
    Returns:
    
    アップデートされたステートメントオブジェクト
  - getPrincipals
```
public List<Principal> getPrincipals()
```
    このステートメントに関連付けられた、プリンシパルのリストを返します。プリンシパルは、このステートメントを適用するユーザアカウントを示します
    
    Returns:
    
    このステートメントに関連付けられた、プリンシパルのリスト
  - setPrincipals
```
public void setPrincipals(Collection<Principal> principals)
```
    このステートメントに関連付けられた、プリンシパルのリストをセットします。プリンシパルは、このステートメントを適用するユーザアカウントを示します
    ポリシーでユーザによるアクセスコントロールを行なわない場合は、 Principal.AllUsers を用いることで、すべてのユーザに対するポリシーを作成することができます
    
    Parameters:
    
    principals - このステートメントに関連付けられた、プリンシパルのリスト
  - withPrincipals
```
public Statement withPrincipals(Principal... principals)
```
    このステートメントに関連付けられた、プリンシパルのリストをセットし連続したメソッドの呼び出しのためにアップデートしたこのオブジェクトを返します。プリンシパルは、このステートメントを適用するユーザアカウントを示します
    ポリシーでユーザによるアクセスコントロールを行なわない場合は、 Principal.AllUsers を用いることで、すべてのユーザに対するポリシーを作成することができます
    
    Parameters:
    
    principals - このステートメントに関連付けられた、プリンシパルのリスト
    
    Returns:
    
    アップデートされたステートメントオブジェクト

Class Statement

Nested Class Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

Statement

Method Detail

getId

setId

withId

getEffect

setEffect

getActions

setActions

withActions

getResources

setResources

withResources

getConditions

setConditions

withConditions

getPrincipals

setPrincipals

withPrincipals