servicequotas

package
v5.0.0 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Mar 21, 2022 License: Apache-2.0 Imports: 7 Imported by: 0

Documentation

Index

Constants

This section is empty.

Variables

This section is empty.

Functions

This section is empty.

Types

type GetServiceArgs 

type GetServiceArgs struct {
	// Service name to lookup within Service Quotas. Available values can be found with the [AWS CLI service-quotas list-services command](https://docs.aws.amazon.com/cli/latest/reference/service-quotas/list-services.html).
	ServiceName string `pulumi:"serviceName"`
}

A collection of arguments for invoking getService.

type GetServiceOutputArgs 

type GetServiceOutputArgs struct {
	// Service name to lookup within Service Quotas. Available values can be found with the [AWS CLI service-quotas list-services command](https://docs.aws.amazon.com/cli/latest/reference/service-quotas/list-services.html).
	ServiceName pulumi.StringInput `pulumi:"serviceName"`
}

A collection of arguments for invoking getService.

func (GetServiceOutputArgs) ElementType 

func (GetServiceOutputArgs) ElementType() reflect.Type

type GetServiceResult 

type GetServiceResult struct {
	// The provider-assigned unique ID for this managed resource.
	Id string `pulumi:"id"`
	// Code of the service.
	ServiceCode string `pulumi:"serviceCode"`
	ServiceName string `pulumi:"serviceName"`
}

A collection of values returned by getService.

func GetService 

func GetService(ctx *pulumi.Context, args *GetServiceArgs, opts ...pulumi.InvokeOption) (*GetServiceResult, error)

Retrieve information about a Service Quotas Service.

> **NOTE:** Global quotas apply to all AWS regions, but can only be accessed in `us-east-1` in the Commercial partition or `us-gov-west-1` in the GovCloud partition. In other regions, the AWS API will return the error `The request failed because the specified service does not exist.`

## Example Usage

```go package main

import ( 

"github.com/pulumi/pulumi-aws/sdk/v5/go/aws/servicequotas"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"

) 

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := servicequotas.GetService(ctx, &servicequotas.GetServiceArgs{
			ServiceName: "Amazon Virtual Private Cloud (Amazon VPC)",
		}, nil)
		if err != nil {
			return err
		}
		return nil
	})
}

```

type GetServiceResultOutput 

type GetServiceResultOutput struct{ *pulumi.OutputState }

A collection of values returned by getService.

func GetServiceOutput 

func GetServiceOutput(ctx *pulumi.Context, args GetServiceOutputArgs, opts ...pulumi.InvokeOption) GetServiceResultOutput

func (GetServiceResultOutput) ElementType 

func (GetServiceResultOutput) ElementType() reflect.Type

func (GetServiceResultOutput) Id 

func (o GetServiceResultOutput) Id() pulumi.StringOutput

The provider-assigned unique ID for this managed resource.

func (GetServiceResultOutput) ServiceCode 

func (o GetServiceResultOutput) ServiceCode() pulumi.StringOutput

Code of the service.

func (GetServiceResultOutput) ServiceName 

func (o GetServiceResultOutput) ServiceName() pulumi.StringOutput

func (GetServiceResultOutput) ToGetServiceResultOutput 

func (o GetServiceResultOutput) ToGetServiceResultOutput() GetServiceResultOutput

func (GetServiceResultOutput) ToGetServiceResultOutputWithContext 

func (o GetServiceResultOutput) ToGetServiceResultOutputWithContext(ctx context.Context) GetServiceResultOutput

type LookupServiceQuotaArgs 

type LookupServiceQuotaArgs struct {
	// Quota code within the service. When configured, the data source directly looks up the service quota. Available values can be found with the [AWS CLI service-quotas list-service-quotas command](https://docs.aws.amazon.com/cli/latest/reference/service-quotas/list-service-quotas.html). One of `quotaCode` or `quotaName` must be specified.
	QuotaCode *string `pulumi:"quotaCode"`
	// Quota name within the service. When configured, the data source searches through all service quotas to find the matching quota name. Available values can be found with the [AWS CLI service-quotas list-service-quotas command](https://docs.aws.amazon.com/cli/latest/reference/service-quotas/list-service-quotas.html). One of `quotaName` or `quotaCode` must be specified.
	QuotaName *string `pulumi:"quotaName"`
	// Service code for the quota. Available values can be found with the `servicequotas.getService` or [AWS CLI service-quotas list-services command](https://docs.aws.amazon.com/cli/latest/reference/service-quotas/list-services.html).
	ServiceCode string `pulumi:"serviceCode"`
}

A collection of arguments for invoking getServiceQuota.

type LookupServiceQuotaOutputArgs 

type LookupServiceQuotaOutputArgs struct {
	// Quota code within the service. When configured, the data source directly looks up the service quota. Available values can be found with the [AWS CLI service-quotas list-service-quotas command](https://docs.aws.amazon.com/cli/latest/reference/service-quotas/list-service-quotas.html). One of `quotaCode` or `quotaName` must be specified.
	QuotaCode pulumi.StringPtrInput `pulumi:"quotaCode"`
	// Quota name within the service. When configured, the data source searches through all service quotas to find the matching quota name. Available values can be found with the [AWS CLI service-quotas list-service-quotas command](https://docs.aws.amazon.com/cli/latest/reference/service-quotas/list-service-quotas.html). One of `quotaName` or `quotaCode` must be specified.
	QuotaName pulumi.StringPtrInput `pulumi:"quotaName"`
	// Service code for the quota. Available values can be found with the `servicequotas.getService` or [AWS CLI service-quotas list-services command](https://docs.aws.amazon.com/cli/latest/reference/service-quotas/list-services.html).
	ServiceCode pulumi.StringInput `pulumi:"serviceCode"`
}

A collection of arguments for invoking getServiceQuota.

func (LookupServiceQuotaOutputArgs) ElementType 

func (LookupServiceQuotaOutputArgs) ElementType() reflect.Type

type LookupServiceQuotaResult 

type LookupServiceQuotaResult struct {
	// Whether the service quota is adjustable.
	Adjustable bool `pulumi:"adjustable"`
	// Amazon Resource Name (ARN) of the service quota.
	Arn string `pulumi:"arn"`
	// Default value of the service quota.
	DefaultValue float64 `pulumi:"defaultValue"`
	// Whether the service quota is global for the AWS account.
	GlobalQuota bool `pulumi:"globalQuota"`
	// The provider-assigned unique ID for this managed resource.
	Id          string `pulumi:"id"`
	QuotaCode   string `pulumi:"quotaCode"`
	QuotaName   string `pulumi:"quotaName"`
	ServiceCode string `pulumi:"serviceCode"`
	// Name of the service.
	ServiceName string `pulumi:"serviceName"`
	// Current value of the service quota.
	Value float64 `pulumi:"value"`
}

A collection of values returned by getServiceQuota.

func LookupServiceQuota 

func LookupServiceQuota(ctx *pulumi.Context, args *LookupServiceQuotaArgs, opts ...pulumi.InvokeOption) (*LookupServiceQuotaResult, error)

Retrieve information about a Service Quota.

> **NOTE:** Global quotas apply to all AWS regions, but can only be accessed in `us-east-1` in the Commercial partition or `us-gov-west-1` in the GovCloud partition. In other regions, the AWS API will return the error `The request failed because the specified service does not exist.`

## Example Usage

```go package main

import ( 

"github.com/pulumi/pulumi-aws/sdk/v5/go/aws/servicequotas"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"

) 

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := servicequotas.LookupServiceQuota(ctx, &servicequotas.LookupServiceQuotaArgs{
			QuotaCode:   pulumi.StringRef("L-F678F1CE"),
			ServiceCode: "vpc",
		}, nil)
		if err != nil {
			return err
		}
		_, err = servicequotas.LookupServiceQuota(ctx, &servicequotas.LookupServiceQuotaArgs{
			QuotaName:   pulumi.StringRef("VPCs per Region"),
			ServiceCode: "vpc",
		}, nil)
		if err != nil {
			return err
		}
		return nil
	})
}

```

type LookupServiceQuotaResultOutput 

type LookupServiceQuotaResultOutput struct{ *pulumi.OutputState }

A collection of values returned by getServiceQuota.

func LookupServiceQuotaOutput 

func LookupServiceQuotaOutput(ctx *pulumi.Context, args LookupServiceQuotaOutputArgs, opts ...pulumi.InvokeOption) LookupServiceQuotaResultOutput

func (LookupServiceQuotaResultOutput) Adjustable 

func (o LookupServiceQuotaResultOutput) Adjustable() pulumi.BoolOutput

Whether the service quota is adjustable.

func (LookupServiceQuotaResultOutput) Arn 

func (o LookupServiceQuotaResultOutput) Arn() pulumi.StringOutput

Amazon Resource Name (ARN) of the service quota.

func (LookupServiceQuotaResultOutput) DefaultValue 

func (o LookupServiceQuotaResultOutput) DefaultValue() pulumi.Float64Output

Default value of the service quota.

func (LookupServiceQuotaResultOutput) ElementType 

func (LookupServiceQuotaResultOutput) ElementType() reflect.Type

func (LookupServiceQuotaResultOutput) GlobalQuota 

func (o LookupServiceQuotaResultOutput) GlobalQuota() pulumi.BoolOutput

Whether the service quota is global for the AWS account.

func (LookupServiceQuotaResultOutput) Id 

func (o LookupServiceQuotaResultOutput) Id() pulumi.StringOutput

The provider-assigned unique ID for this managed resource.

func (LookupServiceQuotaResultOutput) QuotaCode 

func (o LookupServiceQuotaResultOutput) QuotaCode() pulumi.StringOutput

func (LookupServiceQuotaResultOutput) QuotaName 

func (o LookupServiceQuotaResultOutput) QuotaName() pulumi.StringOutput

func (LookupServiceQuotaResultOutput) ServiceCode 

func (o LookupServiceQuotaResultOutput) ServiceCode() pulumi.StringOutput

func (LookupServiceQuotaResultOutput) ServiceName 

func (o LookupServiceQuotaResultOutput) ServiceName() pulumi.StringOutput

Name of the service.

func (LookupServiceQuotaResultOutput) ToLookupServiceQuotaResultOutput 

func (o LookupServiceQuotaResultOutput) ToLookupServiceQuotaResultOutput() LookupServiceQuotaResultOutput

func (LookupServiceQuotaResultOutput) ToLookupServiceQuotaResultOutputWithContext 

func (o LookupServiceQuotaResultOutput) ToLookupServiceQuotaResultOutputWithContext(ctx context.Context) LookupServiceQuotaResultOutput

func (LookupServiceQuotaResultOutput) Value 

func (o LookupServiceQuotaResultOutput) Value() pulumi.Float64Output

Current value of the service quota.

type ServiceQuota 

type ServiceQuota struct {
	pulumi.CustomResourceState

	// Whether the service quota can be increased.
	Adjustable pulumi.BoolOutput `pulumi:"adjustable"`
	// Amazon Resource Name (ARN) of the service quota.
	Arn pulumi.StringOutput `pulumi:"arn"`
	// Default value of the service quota.
	DefaultValue pulumi.Float64Output `pulumi:"defaultValue"`
	// Code of the service quota to track. For example: `L-F678F1CE`. Available values can be found with the [AWS CLI service-quotas list-service-quotas command](https://docs.aws.amazon.com/cli/latest/reference/service-quotas/list-service-quotas.html).
	QuotaCode pulumi.StringOutput `pulumi:"quotaCode"`
	// Name of the quota.
	QuotaName     pulumi.StringOutput `pulumi:"quotaName"`
	RequestId     pulumi.StringOutput `pulumi:"requestId"`
	RequestStatus pulumi.StringOutput `pulumi:"requestStatus"`
	// Code of the service to track. For example: `vpc`. Available values can be found with the [AWS CLI service-quotas list-services command](https://docs.aws.amazon.com/cli/latest/reference/service-quotas/list-services.html).
	ServiceCode pulumi.StringOutput `pulumi:"serviceCode"`
	// Name of the service.
	ServiceName pulumi.StringOutput `pulumi:"serviceName"`
	// Float specifying the desired value for the service quota. If the desired value is higher than the current value, a quota increase request is submitted. When a known request is submitted and pending, the value reflects the desired value of the pending request.
	Value pulumi.Float64Output `pulumi:"value"`
}

Manages an individual Service Quota.

> **NOTE:** Global quotas apply to all AWS regions, but can only be accessed in `us-east-1` in the Commercial partition or `us-gov-west-1` in the GovCloud partition. In other regions, the AWS API will return the error `The request failed because the specified service does not exist.`

## Example Usage

```go package main

import ( 

"github.com/pulumi/pulumi-aws/sdk/v5/go/aws/servicequotas"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"

) 

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := servicequotas.NewServiceQuota(ctx, "example", &servicequotas.ServiceQuotaArgs{
			QuotaCode:   pulumi.String("L-F678F1CE"),
			ServiceCode: pulumi.String("vpc"),
			Value:       pulumi.Float64(75),
		})
		if err != nil {
			return err
		}
		return nil
	})
}

```

## Import

~> *NOTE* This resource does not require explicit import and will assume management of an existing service quota on resource creation. `aws_servicequotas_service_quota` can be imported by using the service code and quota code, separated by a front slash (`/`), e.g.,

```sh 

$ pulumi import aws:servicequotas/serviceQuota:ServiceQuota example vpc/L-F678F1CE

```

func GetServiceQuota 

func GetServiceQuota(ctx *pulumi.Context,
	name string, id pulumi.IDInput, state *ServiceQuotaState, opts ...pulumi.ResourceOption) (*ServiceQuota, error)

GetServiceQuota gets an existing ServiceQuota resource's state with the given name, ID, and optional state properties that are used to uniquely qualify the lookup (nil if not required).

func NewServiceQuota 

func NewServiceQuota(ctx *pulumi.Context,
	name string, args *ServiceQuotaArgs, opts ...pulumi.ResourceOption) (*ServiceQuota, error)

NewServiceQuota registers a new resource with the given unique name, arguments, and options.

func (*ServiceQuota) ElementType 

func (*ServiceQuota) ElementType() reflect.Type

func (*ServiceQuota) ToServiceQuotaOutput 

func (i *ServiceQuota) ToServiceQuotaOutput() ServiceQuotaOutput

func (*ServiceQuota) ToServiceQuotaOutputWithContext 

func (i *ServiceQuota) ToServiceQuotaOutputWithContext(ctx context.Context) ServiceQuotaOutput

type ServiceQuotaArgs 

type ServiceQuotaArgs struct {
	// Code of the service quota to track. For example: `L-F678F1CE`. Available values can be found with the [AWS CLI service-quotas list-service-quotas command](https://docs.aws.amazon.com/cli/latest/reference/service-quotas/list-service-quotas.html).
	QuotaCode pulumi.StringInput
	// Code of the service to track. For example: `vpc`. Available values can be found with the [AWS CLI service-quotas list-services command](https://docs.aws.amazon.com/cli/latest/reference/service-quotas/list-services.html).
	ServiceCode pulumi.StringInput
	// Float specifying the desired value for the service quota. If the desired value is higher than the current value, a quota increase request is submitted. When a known request is submitted and pending, the value reflects the desired value of the pending request.
	Value pulumi.Float64Input
}

The set of arguments for constructing a ServiceQuota resource.

func (ServiceQuotaArgs) ElementType 

func (ServiceQuotaArgs) ElementType() reflect.Type

type ServiceQuotaArray 

type ServiceQuotaArray []ServiceQuotaInput

func (ServiceQuotaArray) ElementType 

func (ServiceQuotaArray) ElementType() reflect.Type

func (ServiceQuotaArray) ToServiceQuotaArrayOutput 

func (i ServiceQuotaArray) ToServiceQuotaArrayOutput() ServiceQuotaArrayOutput

func (ServiceQuotaArray) ToServiceQuotaArrayOutputWithContext 

func (i ServiceQuotaArray) ToServiceQuotaArrayOutputWithContext(ctx context.Context) ServiceQuotaArrayOutput

type ServiceQuotaArrayInput 

type ServiceQuotaArrayInput interface {
	pulumi.Input

	ToServiceQuotaArrayOutput() ServiceQuotaArrayOutput
	ToServiceQuotaArrayOutputWithContext(context.Context) ServiceQuotaArrayOutput
}

ServiceQuotaArrayInput is an input type that accepts ServiceQuotaArray and ServiceQuotaArrayOutput values. You can construct a concrete instance of `ServiceQuotaArrayInput` via: 

ServiceQuotaArray{ ServiceQuotaArgs{...} }

type ServiceQuotaArrayOutput 

type ServiceQuotaArrayOutput struct{ *pulumi.OutputState }

func (ServiceQuotaArrayOutput) ElementType 

func (ServiceQuotaArrayOutput) ElementType() reflect.Type

func (ServiceQuotaArrayOutput) Index 

func (o ServiceQuotaArrayOutput) Index(i pulumi.IntInput) ServiceQuotaOutput

func (ServiceQuotaArrayOutput) ToServiceQuotaArrayOutput 

func (o ServiceQuotaArrayOutput) ToServiceQuotaArrayOutput() ServiceQuotaArrayOutput

func (ServiceQuotaArrayOutput) ToServiceQuotaArrayOutputWithContext 

func (o ServiceQuotaArrayOutput) ToServiceQuotaArrayOutputWithContext(ctx context.Context) ServiceQuotaArrayOutput

type ServiceQuotaInput 

type ServiceQuotaInput interface {
	pulumi.Input

	ToServiceQuotaOutput() ServiceQuotaOutput
	ToServiceQuotaOutputWithContext(ctx context.Context) ServiceQuotaOutput
}

type ServiceQuotaMap 

type ServiceQuotaMap map[string]ServiceQuotaInput

func (ServiceQuotaMap) ElementType 

func (ServiceQuotaMap) ElementType() reflect.Type

func (ServiceQuotaMap) ToServiceQuotaMapOutput 

func (i ServiceQuotaMap) ToServiceQuotaMapOutput() ServiceQuotaMapOutput

func (ServiceQuotaMap) ToServiceQuotaMapOutputWithContext 

func (i ServiceQuotaMap) ToServiceQuotaMapOutputWithContext(ctx context.Context) ServiceQuotaMapOutput

type ServiceQuotaMapInput 

type ServiceQuotaMapInput interface {
	pulumi.Input

	ToServiceQuotaMapOutput() ServiceQuotaMapOutput
	ToServiceQuotaMapOutputWithContext(context.Context) ServiceQuotaMapOutput
}

ServiceQuotaMapInput is an input type that accepts ServiceQuotaMap and ServiceQuotaMapOutput values. You can construct a concrete instance of `ServiceQuotaMapInput` via: 

ServiceQuotaMap{ "key": ServiceQuotaArgs{...} }

type ServiceQuotaMapOutput 

type ServiceQuotaMapOutput struct{ *pulumi.OutputState }

func (ServiceQuotaMapOutput) ElementType 

func (ServiceQuotaMapOutput) ElementType() reflect.Type

func (ServiceQuotaMapOutput) MapIndex 

func (o ServiceQuotaMapOutput) MapIndex(k pulumi.StringInput) ServiceQuotaOutput

func (ServiceQuotaMapOutput) ToServiceQuotaMapOutput 

func (o ServiceQuotaMapOutput) ToServiceQuotaMapOutput() ServiceQuotaMapOutput

func (ServiceQuotaMapOutput) ToServiceQuotaMapOutputWithContext 

func (o ServiceQuotaMapOutput) ToServiceQuotaMapOutputWithContext(ctx context.Context) ServiceQuotaMapOutput

type ServiceQuotaOutput 

type ServiceQuotaOutput struct{ *pulumi.OutputState }

func (ServiceQuotaOutput) ElementType 

func (ServiceQuotaOutput) ElementType() reflect.Type

func (ServiceQuotaOutput) ToServiceQuotaOutput 

func (o ServiceQuotaOutput) ToServiceQuotaOutput() ServiceQuotaOutput

func (ServiceQuotaOutput) ToServiceQuotaOutputWithContext 

func (o ServiceQuotaOutput) ToServiceQuotaOutputWithContext(ctx context.Context) ServiceQuotaOutput

type ServiceQuotaState 

type ServiceQuotaState struct {
	// Whether the service quota can be increased.
	Adjustable pulumi.BoolPtrInput
	// Amazon Resource Name (ARN) of the service quota.
	Arn pulumi.StringPtrInput
	// Default value of the service quota.
	DefaultValue pulumi.Float64PtrInput
	// Code of the service quota to track. For example: `L-F678F1CE`. Available values can be found with the [AWS CLI service-quotas list-service-quotas command](https://docs.aws.amazon.com/cli/latest/reference/service-quotas/list-service-quotas.html).
	QuotaCode pulumi.StringPtrInput
	// Name of the quota.
	QuotaName     pulumi.StringPtrInput
	RequestId     pulumi.StringPtrInput
	RequestStatus pulumi.StringPtrInput
	// Code of the service to track. For example: `vpc`. Available values can be found with the [AWS CLI service-quotas list-services command](https://docs.aws.amazon.com/cli/latest/reference/service-quotas/list-services.html).
	ServiceCode pulumi.StringPtrInput
	// Name of the service.
	ServiceName pulumi.StringPtrInput
	// Float specifying the desired value for the service quota. If the desired value is higher than the current value, a quota increase request is submitted. When a known request is submitted and pending, the value reflects the desired value of the pending request.
	Value pulumi.Float64PtrInput
}

func (ServiceQuotaState) ElementType 

func (ServiceQuotaState) ElementType() reflect.Type

Source Files

View all Source files

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.