https://github.com/myerscode/aws-meta
Golang package to consume meta data about AWS Regions, Partions and Services
https://github.com/myerscode/aws-meta
aws aws-meta aws-partition aws-region
Last synced: 24 days ago
JSON representation
Golang package to consume meta data about AWS Regions, Partions and Services
- Host: GitHub
- URL: https://github.com/myerscode/aws-meta
- Owner: myerscode
- License: mit
- Created: 2025-05-27T20:43:08.000Z (11 months ago)
- Default Branch: main
- Last Pushed: 2026-02-10T03:16:26.000Z (about 2 months ago)
- Last Synced: 2026-02-10T08:40:40.784Z (about 2 months ago)
- Topics: aws, aws-meta, aws-partition, aws-region
- Language: Go
- Homepage:
- Size: 12.2 MB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# AWS Metadata
> A Go package for exposing information about AWS Partitions, Regions and Services
[](https://github.com/myerscode/aws-meta/actions/workflows/go.yml)
[](https://github.com/myerscode/aws-meta/actions/workflows/nightly-update.yml)
[](https://github.com/myerscode/aws-meta/actions/workflows/weekly-release.yml)
[](https://pkg.go.dev/github.com/myerscode/aws-meta)
[](https://goreportcard.com/report/github.com/myerscode/aws-meta)
Knowing what AWS services are available in which regions and partitions can be a bit of a pain;
this package aims to keep an up to date reference for the available endpoints for all AWS services.
## Features
- **Partitions**: Get all AWS partition names (aws, aws-cn, aws-us-gov)
- **Regions**: List all AWS regions across all partitions
- **Services**: Access AWS service information and operations
- **Regional Services**: Find which services are available in specific regions
- **Service Operations**: Get all available operations for any AWS service
## Installation
```bash
go get github.com/myerscode/aws-meta
```
## Quick Start
### Working with Partitions
```go
import "github.com/myerscode/aws-meta/pkg/partitions"
// Get all partition names
partitions := partitions.AllPartitionNames()
fmt.Printf("Available partitions: %v\n", partitions)
// Get detailed partition information
partitionList, err := partitions.List()
if err != nil {
log.Fatal(err)
}
// Get partitions by type
commercial, _ := partitions.CommercialPartitions()
sovereign, _ := partitions.SovereignPartitions()
isolated, _ := partitions.IsolatedPartitions()
```
### Working with Services and Regions
```go
import "github.com/myerscode/aws-meta/pkg/services"
// Get all regions
regions := services.AllRegionNames()
// Get detailed service metadata
services, err := services.ServiceMeta()
if err != nil {
log.Fatal(err)
}
// Get services available in a specific region
regionServices, err := services.ServiceMetaForRegion("us-east-1")
if err != nil {
log.Fatal(err)
}
// Get service operations
operations, err := services.ServiceOperations("S3")
if err != nil {
log.Fatal(err)
}
```
## Documentation
- [API Reference](docs/methods.md) - Overview of all packages and functions
- [Partitions Package](docs/partitions.md) - Partition-related functions
- [Services Package](docs/services.md) - Service and region functions
- [Examples](docs/examples.md) - Usage examples and complete code samples