oci.Provider
Explore with Pulumi AI
The provider type for the oci package. By default, resources use package-wide configuration
settings, however an explicit Provider
instance may be created and passed during resource
construction to achieve fine-grained programmatic control over provider settings. See the
documentation for more information.
Create Provider Resource
Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.
Constructor syntax
new Provider(name: string, args?: ProviderArgs, opts?: CustomResourceOptions);
@overload
def Provider(resource_name: str,
args: Optional[ProviderArgs] = None,
opts: Optional[ResourceOptions] = None)
@overload
def Provider(resource_name: str,
opts: Optional[ResourceOptions] = None,
auth: Optional[str] = None,
config_file_profile: Optional[str] = None,
disable_auto_retries: Optional[bool] = None,
fingerprint: Optional[str] = None,
ignore_defined_tags: Optional[Sequence[str]] = None,
private_key: Optional[str] = None,
private_key_password: Optional[str] = None,
private_key_path: Optional[str] = None,
realm_specific_service_endpoint_template_enabled: Optional[bool] = None,
region: Optional[str] = None,
retry_duration_seconds: Optional[int] = None,
tenancy_ocid: Optional[str] = None,
user_ocid: Optional[str] = None)
func NewProvider(ctx *Context, name string, args *ProviderArgs, opts ...ResourceOption) (*Provider, error)
public Provider(string name, ProviderArgs? args = null, CustomResourceOptions? opts = null)
public Provider(String name, ProviderArgs args)
public Provider(String name, ProviderArgs args, CustomResourceOptions options)
type: pulumi:providers:oci
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.
Parameters
- name string
- The unique name of the resource.
- args ProviderArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- resource_name str
- The unique name of the resource.
- args ProviderArgs
- The arguments to resource properties.
- opts ResourceOptions
- Bag of options to control resource's behavior.
- ctx Context
- Context object for the current deployment.
- name string
- The unique name of the resource.
- args ProviderArgs
- The arguments to resource properties.
- opts ResourceOption
- Bag of options to control resource's behavior.
- name string
- The unique name of the resource.
- args ProviderArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- name String
- The unique name of the resource.
- args ProviderArgs
- The arguments to resource properties.
- options CustomResourceOptions
- Bag of options to control resource's behavior.
Provider Resource Properties
To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.
Inputs
In Python, inputs that are objects can be passed either as argument classes or as dictionary literals.
The Provider resource accepts the following input properties:
- Auth string
- (Optional) The type of auth to use. Options are 'ApiKey', 'SecurityToken', 'InstancePrincipal', 'ResourcePrincipal' and 'OKEWorkloadIdentity'. By default, 'ApiKey' will be used.
- Config
File stringProfile - (Optional) The profile name to be used from config file, if not set it will be DEFAULT.
- Disable
Auto boolRetries - (Optional) Disable automatic retries for retriable errors. Automatic retries were introduced to solve some eventual consistency problems but it also introduced performance issues on destroy operations.
- Fingerprint string
- (Optional) The fingerprint for the user's RSA key. This can be found in user settings in the Oracle Cloud Infrastructure console. Required if auth is set to 'ApiKey', ignored otherwise.
- List<string>
- Private
Key string - (Optional) A PEM formatted RSA private key for the user. A private_key or a private_key_path must be provided if auth is set to 'ApiKey', ignored otherwise.
- Private
Key stringPassword - (Optional) The password used to secure the private key.
- Private
Key stringPath - (Optional) The path to the user's PEM formatted private key. A private_key or a private_key_path must be provided if auth is set to 'ApiKey', ignored otherwise.
- Realm
Specific boolService Endpoint Template Enabled - (Optional) flags to enable realm specific service endpoint.
- Region string
- (Required) The region for API connections (e.g. us-ashburn-1).
- Retry
Duration intSeconds - (Optional) The minimum duration (in seconds) to retry a resource operation in response to an error. The actual retry
duration may be longer due to jittering of retry operations. This value is ignored if the
disable_auto_retries
field is set to true. - Tenancy
Ocid string - (Optional) The tenancy OCID for a user. The tenancy OCID can be found at the bottom of user settings in the Oracle Cloud Infrastructure console. Required if auth is set to 'ApiKey', ignored otherwise.
- User
Ocid string - (Optional) The user OCID. This can be found in user settings in the Oracle Cloud Infrastructure console. Required if auth is set to 'ApiKey', ignored otherwise.
- Auth string
- (Optional) The type of auth to use. Options are 'ApiKey', 'SecurityToken', 'InstancePrincipal', 'ResourcePrincipal' and 'OKEWorkloadIdentity'. By default, 'ApiKey' will be used.
- Config
File stringProfile - (Optional) The profile name to be used from config file, if not set it will be DEFAULT.
- Disable
Auto boolRetries - (Optional) Disable automatic retries for retriable errors. Automatic retries were introduced to solve some eventual consistency problems but it also introduced performance issues on destroy operations.
- Fingerprint string
- (Optional) The fingerprint for the user's RSA key. This can be found in user settings in the Oracle Cloud Infrastructure console. Required if auth is set to 'ApiKey', ignored otherwise.
- []string
- Private
Key string - (Optional) A PEM formatted RSA private key for the user. A private_key or a private_key_path must be provided if auth is set to 'ApiKey', ignored otherwise.
- Private
Key stringPassword - (Optional) The password used to secure the private key.
- Private
Key stringPath - (Optional) The path to the user's PEM formatted private key. A private_key or a private_key_path must be provided if auth is set to 'ApiKey', ignored otherwise.
- Realm
Specific boolService Endpoint Template Enabled - (Optional) flags to enable realm specific service endpoint.
- Region string
- (Required) The region for API connections (e.g. us-ashburn-1).
- Retry
Duration intSeconds - (Optional) The minimum duration (in seconds) to retry a resource operation in response to an error. The actual retry
duration may be longer due to jittering of retry operations. This value is ignored if the
disable_auto_retries
field is set to true. - Tenancy
Ocid string - (Optional) The tenancy OCID for a user. The tenancy OCID can be found at the bottom of user settings in the Oracle Cloud Infrastructure console. Required if auth is set to 'ApiKey', ignored otherwise.
- User
Ocid string - (Optional) The user OCID. This can be found in user settings in the Oracle Cloud Infrastructure console. Required if auth is set to 'ApiKey', ignored otherwise.
- auth String
- (Optional) The type of auth to use. Options are 'ApiKey', 'SecurityToken', 'InstancePrincipal', 'ResourcePrincipal' and 'OKEWorkloadIdentity'. By default, 'ApiKey' will be used.
- config
File StringProfile - (Optional) The profile name to be used from config file, if not set it will be DEFAULT.
- disable
Auto BooleanRetries - (Optional) Disable automatic retries for retriable errors. Automatic retries were introduced to solve some eventual consistency problems but it also introduced performance issues on destroy operations.
- fingerprint String
- (Optional) The fingerprint for the user's RSA key. This can be found in user settings in the Oracle Cloud Infrastructure console. Required if auth is set to 'ApiKey', ignored otherwise.
- List<String>
- private
Key String - (Optional) A PEM formatted RSA private key for the user. A private_key or a private_key_path must be provided if auth is set to 'ApiKey', ignored otherwise.
- private
Key StringPassword - (Optional) The password used to secure the private key.
- private
Key StringPath - (Optional) The path to the user's PEM formatted private key. A private_key or a private_key_path must be provided if auth is set to 'ApiKey', ignored otherwise.
- realm
Specific BooleanService Endpoint Template Enabled - (Optional) flags to enable realm specific service endpoint.
- region String
- (Required) The region for API connections (e.g. us-ashburn-1).
- retry
Duration IntegerSeconds - (Optional) The minimum duration (in seconds) to retry a resource operation in response to an error. The actual retry
duration may be longer due to jittering of retry operations. This value is ignored if the
disable_auto_retries
field is set to true. - tenancy
Ocid String - (Optional) The tenancy OCID for a user. The tenancy OCID can be found at the bottom of user settings in the Oracle Cloud Infrastructure console. Required if auth is set to 'ApiKey', ignored otherwise.
- user
Ocid String - (Optional) The user OCID. This can be found in user settings in the Oracle Cloud Infrastructure console. Required if auth is set to 'ApiKey', ignored otherwise.
- auth string
- (Optional) The type of auth to use. Options are 'ApiKey', 'SecurityToken', 'InstancePrincipal', 'ResourcePrincipal' and 'OKEWorkloadIdentity'. By default, 'ApiKey' will be used.
- config
File stringProfile - (Optional) The profile name to be used from config file, if not set it will be DEFAULT.
- disable
Auto booleanRetries - (Optional) Disable automatic retries for retriable errors. Automatic retries were introduced to solve some eventual consistency problems but it also introduced performance issues on destroy operations.
- fingerprint string
- (Optional) The fingerprint for the user's RSA key. This can be found in user settings in the Oracle Cloud Infrastructure console. Required if auth is set to 'ApiKey', ignored otherwise.
- string[]
- private
Key string - (Optional) A PEM formatted RSA private key for the user. A private_key or a private_key_path must be provided if auth is set to 'ApiKey', ignored otherwise.
- private
Key stringPassword - (Optional) The password used to secure the private key.
- private
Key stringPath - (Optional) The path to the user's PEM formatted private key. A private_key or a private_key_path must be provided if auth is set to 'ApiKey', ignored otherwise.
- realm
Specific booleanService Endpoint Template Enabled - (Optional) flags to enable realm specific service endpoint.
- region string
- (Required) The region for API connections (e.g. us-ashburn-1).
- retry
Duration numberSeconds - (Optional) The minimum duration (in seconds) to retry a resource operation in response to an error. The actual retry
duration may be longer due to jittering of retry operations. This value is ignored if the
disable_auto_retries
field is set to true. - tenancy
Ocid string - (Optional) The tenancy OCID for a user. The tenancy OCID can be found at the bottom of user settings in the Oracle Cloud Infrastructure console. Required if auth is set to 'ApiKey', ignored otherwise.
- user
Ocid string - (Optional) The user OCID. This can be found in user settings in the Oracle Cloud Infrastructure console. Required if auth is set to 'ApiKey', ignored otherwise.
- auth str
- (Optional) The type of auth to use. Options are 'ApiKey', 'SecurityToken', 'InstancePrincipal', 'ResourcePrincipal' and 'OKEWorkloadIdentity'. By default, 'ApiKey' will be used.
- config_
file_ strprofile - (Optional) The profile name to be used from config file, if not set it will be DEFAULT.
- disable_
auto_ boolretries - (Optional) Disable automatic retries for retriable errors. Automatic retries were introduced to solve some eventual consistency problems but it also introduced performance issues on destroy operations.
- fingerprint str
- (Optional) The fingerprint for the user's RSA key. This can be found in user settings in the Oracle Cloud Infrastructure console. Required if auth is set to 'ApiKey', ignored otherwise.
- Sequence[str]
- private_
key str - (Optional) A PEM formatted RSA private key for the user. A private_key or a private_key_path must be provided if auth is set to 'ApiKey', ignored otherwise.
- private_
key_ strpassword - (Optional) The password used to secure the private key.
- private_
key_ strpath - (Optional) The path to the user's PEM formatted private key. A private_key or a private_key_path must be provided if auth is set to 'ApiKey', ignored otherwise.
- realm_
specific_ boolservice_ endpoint_ template_ enabled - (Optional) flags to enable realm specific service endpoint.
- region str
- (Required) The region for API connections (e.g. us-ashburn-1).
- retry_
duration_ intseconds - (Optional) The minimum duration (in seconds) to retry a resource operation in response to an error. The actual retry
duration may be longer due to jittering of retry operations. This value is ignored if the
disable_auto_retries
field is set to true. - tenancy_
ocid str - (Optional) The tenancy OCID for a user. The tenancy OCID can be found at the bottom of user settings in the Oracle Cloud Infrastructure console. Required if auth is set to 'ApiKey', ignored otherwise.
- user_
ocid str - (Optional) The user OCID. This can be found in user settings in the Oracle Cloud Infrastructure console. Required if auth is set to 'ApiKey', ignored otherwise.
- auth String
- (Optional) The type of auth to use. Options are 'ApiKey', 'SecurityToken', 'InstancePrincipal', 'ResourcePrincipal' and 'OKEWorkloadIdentity'. By default, 'ApiKey' will be used.
- config
File StringProfile - (Optional) The profile name to be used from config file, if not set it will be DEFAULT.
- disable
Auto BooleanRetries - (Optional) Disable automatic retries for retriable errors. Automatic retries were introduced to solve some eventual consistency problems but it also introduced performance issues on destroy operations.
- fingerprint String
- (Optional) The fingerprint for the user's RSA key. This can be found in user settings in the Oracle Cloud Infrastructure console. Required if auth is set to 'ApiKey', ignored otherwise.
- List<String>
- private
Key String - (Optional) A PEM formatted RSA private key for the user. A private_key or a private_key_path must be provided if auth is set to 'ApiKey', ignored otherwise.
- private
Key StringPassword - (Optional) The password used to secure the private key.
- private
Key StringPath - (Optional) The path to the user's PEM formatted private key. A private_key or a private_key_path must be provided if auth is set to 'ApiKey', ignored otherwise.
- realm
Specific BooleanService Endpoint Template Enabled - (Optional) flags to enable realm specific service endpoint.
- region String
- (Required) The region for API connections (e.g. us-ashburn-1).
- retry
Duration NumberSeconds - (Optional) The minimum duration (in seconds) to retry a resource operation in response to an error. The actual retry
duration may be longer due to jittering of retry operations. This value is ignored if the
disable_auto_retries
field is set to true. - tenancy
Ocid String - (Optional) The tenancy OCID for a user. The tenancy OCID can be found at the bottom of user settings in the Oracle Cloud Infrastructure console. Required if auth is set to 'ApiKey', ignored otherwise.
- user
Ocid String - (Optional) The user OCID. This can be found in user settings in the Oracle Cloud Infrastructure console. Required if auth is set to 'ApiKey', ignored otherwise.
Outputs
All input properties are implicitly available as output properties. Additionally, the Provider resource produces the following output properties:
- Id string
- The provider-assigned unique ID for this managed resource.
- Id string
- The provider-assigned unique ID for this managed resource.
- id String
- The provider-assigned unique ID for this managed resource.
- id string
- The provider-assigned unique ID for this managed resource.
- id str
- The provider-assigned unique ID for this managed resource.
- id String
- The provider-assigned unique ID for this managed resource.
Package Details
- Repository
- oci pulumi/pulumi-oci
- License
- Apache-2.0
- Notes
- This Pulumi package is based on the
oci
Terraform Provider.