github.com/pulumi/pulumi-aws/sdk/v6@v6.32.0/go/aws/s3control/getMultiRegionAccessPoint.go (about)

     1  // Code generated by the Pulumi Terraform Bridge (tfgen) Tool DO NOT EDIT.
     2  // *** WARNING: Do not edit by hand unless you're certain you know what you are doing! ***
     3  
     4  package s3control
     5  
     6  import (
     7  	"context"
     8  	"reflect"
     9  
    10  	"github.com/pulumi/pulumi-aws/sdk/v6/go/aws/internal"
    11  	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
    12  )
    13  
    14  // Provides details on a specific S3 Multi-Region Access Point.
    15  //
    16  // ## Example Usage
    17  //
    18  // <!--Start PulumiCodeChooser -->
    19  // ```go
    20  // package main
    21  //
    22  // import (
    23  //
    24  //	"github.com/pulumi/pulumi-aws/sdk/v6/go/aws/s3control"
    25  //	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
    26  //
    27  // )
    28  //
    29  //	func main() {
    30  //		pulumi.Run(func(ctx *pulumi.Context) error {
    31  //			_, err := s3control.LookupMultiRegionAccessPoint(ctx, &s3control.LookupMultiRegionAccessPointArgs{
    32  //				Name: "example",
    33  //			}, nil)
    34  //			if err != nil {
    35  //				return err
    36  //			}
    37  //			return nil
    38  //		})
    39  //	}
    40  //
    41  // ```
    42  // <!--End PulumiCodeChooser -->
    43  func LookupMultiRegionAccessPoint(ctx *pulumi.Context, args *LookupMultiRegionAccessPointArgs, opts ...pulumi.InvokeOption) (*LookupMultiRegionAccessPointResult, error) {
    44  	opts = internal.PkgInvokeDefaultOpts(opts)
    45  	var rv LookupMultiRegionAccessPointResult
    46  	err := ctx.Invoke("aws:s3control/getMultiRegionAccessPoint:getMultiRegionAccessPoint", args, &rv, opts...)
    47  	if err != nil {
    48  		return nil, err
    49  	}
    50  	return &rv, nil
    51  }
    52  
    53  // A collection of arguments for invoking getMultiRegionAccessPoint.
    54  type LookupMultiRegionAccessPointArgs struct {
    55  	// The AWS account ID of the S3 Multi-Region Access Point. Defaults to automatically determined account ID of the AWS provider.
    56  	AccountId *string `pulumi:"accountId"`
    57  	// The name of the Multi-Region Access Point.
    58  	Name string `pulumi:"name"`
    59  }
    60  
    61  // A collection of values returned by getMultiRegionAccessPoint.
    62  type LookupMultiRegionAccessPointResult struct {
    63  	AccountId string `pulumi:"accountId"`
    64  	// The alias for the Multi-Region Access Point.
    65  	Alias string `pulumi:"alias"`
    66  	// Amazon Resource Name (ARN) of the Multi-Region Access Point.
    67  	Arn string `pulumi:"arn"`
    68  	// Timestamp when the resource has been created.
    69  	CreatedAt string `pulumi:"createdAt"`
    70  	// The DNS domain name of the S3 Multi-Region Access Point in the format _`alias`_.accesspoint.s3-global.amazonaws.com. For more information, see the documentation on [Multi-Region Access Point Requests](https://docs.aws.amazon.com/AmazonS3/latest/userguide/MultiRegionAccessPointRequests.html).
    71  	DomainName string `pulumi:"domainName"`
    72  	// The provider-assigned unique ID for this managed resource.
    73  	Id   string `pulumi:"id"`
    74  	Name string `pulumi:"name"`
    75  	// Public Access Block of the Multi-Region Access Point. Detailed below.
    76  	PublicAccessBlocks []GetMultiRegionAccessPointPublicAccessBlock `pulumi:"publicAccessBlocks"`
    77  	// A collection of the regions and buckets associated with the Multi-Region Access Point.
    78  	Regions []GetMultiRegionAccessPointRegion `pulumi:"regions"`
    79  	// The current status of the Multi-Region Access Point.
    80  	Status string `pulumi:"status"`
    81  }
    82  
    83  func LookupMultiRegionAccessPointOutput(ctx *pulumi.Context, args LookupMultiRegionAccessPointOutputArgs, opts ...pulumi.InvokeOption) LookupMultiRegionAccessPointResultOutput {
    84  	return pulumi.ToOutputWithContext(context.Background(), args).
    85  		ApplyT(func(v interface{}) (LookupMultiRegionAccessPointResult, error) {
    86  			args := v.(LookupMultiRegionAccessPointArgs)
    87  			r, err := LookupMultiRegionAccessPoint(ctx, &args, opts...)
    88  			var s LookupMultiRegionAccessPointResult
    89  			if r != nil {
    90  				s = *r
    91  			}
    92  			return s, err
    93  		}).(LookupMultiRegionAccessPointResultOutput)
    94  }
    95  
    96  // A collection of arguments for invoking getMultiRegionAccessPoint.
    97  type LookupMultiRegionAccessPointOutputArgs struct {
    98  	// The AWS account ID of the S3 Multi-Region Access Point. Defaults to automatically determined account ID of the AWS provider.
    99  	AccountId pulumi.StringPtrInput `pulumi:"accountId"`
   100  	// The name of the Multi-Region Access Point.
   101  	Name pulumi.StringInput `pulumi:"name"`
   102  }
   103  
   104  func (LookupMultiRegionAccessPointOutputArgs) ElementType() reflect.Type {
   105  	return reflect.TypeOf((*LookupMultiRegionAccessPointArgs)(nil)).Elem()
   106  }
   107  
   108  // A collection of values returned by getMultiRegionAccessPoint.
   109  type LookupMultiRegionAccessPointResultOutput struct{ *pulumi.OutputState }
   110  
   111  func (LookupMultiRegionAccessPointResultOutput) ElementType() reflect.Type {
   112  	return reflect.TypeOf((*LookupMultiRegionAccessPointResult)(nil)).Elem()
   113  }
   114  
   115  func (o LookupMultiRegionAccessPointResultOutput) ToLookupMultiRegionAccessPointResultOutput() LookupMultiRegionAccessPointResultOutput {
   116  	return o
   117  }
   118  
   119  func (o LookupMultiRegionAccessPointResultOutput) ToLookupMultiRegionAccessPointResultOutputWithContext(ctx context.Context) LookupMultiRegionAccessPointResultOutput {
   120  	return o
   121  }
   122  
   123  func (o LookupMultiRegionAccessPointResultOutput) AccountId() pulumi.StringOutput {
   124  	return o.ApplyT(func(v LookupMultiRegionAccessPointResult) string { return v.AccountId }).(pulumi.StringOutput)
   125  }
   126  
   127  // The alias for the Multi-Region Access Point.
   128  func (o LookupMultiRegionAccessPointResultOutput) Alias() pulumi.StringOutput {
   129  	return o.ApplyT(func(v LookupMultiRegionAccessPointResult) string { return v.Alias }).(pulumi.StringOutput)
   130  }
   131  
   132  // Amazon Resource Name (ARN) of the Multi-Region Access Point.
   133  func (o LookupMultiRegionAccessPointResultOutput) Arn() pulumi.StringOutput {
   134  	return o.ApplyT(func(v LookupMultiRegionAccessPointResult) string { return v.Arn }).(pulumi.StringOutput)
   135  }
   136  
   137  // Timestamp when the resource has been created.
   138  func (o LookupMultiRegionAccessPointResultOutput) CreatedAt() pulumi.StringOutput {
   139  	return o.ApplyT(func(v LookupMultiRegionAccessPointResult) string { return v.CreatedAt }).(pulumi.StringOutput)
   140  }
   141  
   142  // The DNS domain name of the S3 Multi-Region Access Point in the format _`alias`_.accesspoint.s3-global.amazonaws.com. For more information, see the documentation on [Multi-Region Access Point Requests](https://docs.aws.amazon.com/AmazonS3/latest/userguide/MultiRegionAccessPointRequests.html).
   143  func (o LookupMultiRegionAccessPointResultOutput) DomainName() pulumi.StringOutput {
   144  	return o.ApplyT(func(v LookupMultiRegionAccessPointResult) string { return v.DomainName }).(pulumi.StringOutput)
   145  }
   146  
   147  // The provider-assigned unique ID for this managed resource.
   148  func (o LookupMultiRegionAccessPointResultOutput) Id() pulumi.StringOutput {
   149  	return o.ApplyT(func(v LookupMultiRegionAccessPointResult) string { return v.Id }).(pulumi.StringOutput)
   150  }
   151  
   152  func (o LookupMultiRegionAccessPointResultOutput) Name() pulumi.StringOutput {
   153  	return o.ApplyT(func(v LookupMultiRegionAccessPointResult) string { return v.Name }).(pulumi.StringOutput)
   154  }
   155  
   156  // Public Access Block of the Multi-Region Access Point. Detailed below.
   157  func (o LookupMultiRegionAccessPointResultOutput) PublicAccessBlocks() GetMultiRegionAccessPointPublicAccessBlockArrayOutput {
   158  	return o.ApplyT(func(v LookupMultiRegionAccessPointResult) []GetMultiRegionAccessPointPublicAccessBlock {
   159  		return v.PublicAccessBlocks
   160  	}).(GetMultiRegionAccessPointPublicAccessBlockArrayOutput)
   161  }
   162  
   163  // A collection of the regions and buckets associated with the Multi-Region Access Point.
   164  func (o LookupMultiRegionAccessPointResultOutput) Regions() GetMultiRegionAccessPointRegionArrayOutput {
   165  	return o.ApplyT(func(v LookupMultiRegionAccessPointResult) []GetMultiRegionAccessPointRegion { return v.Regions }).(GetMultiRegionAccessPointRegionArrayOutput)
   166  }
   167  
   168  // The current status of the Multi-Region Access Point.
   169  func (o LookupMultiRegionAccessPointResultOutput) Status() pulumi.StringOutput {
   170  	return o.ApplyT(func(v LookupMultiRegionAccessPointResult) string { return v.Status }).(pulumi.StringOutput)
   171  }
   172  
   173  func init() {
   174  	pulumi.RegisterOutputType(LookupMultiRegionAccessPointResultOutput{})
   175  }